Google Cloud-Projekte

Jedes Apps Script-Projekt verwendet Google Cloud, um Autorisierungen, erweiterte Dienste und andere Details zu verwalten. Zum Konfigurieren und Verwalten dieser Einstellungen ist jedem Apps Script-Projekt ein Google Cloud-Projekt zugeordnet. Ihr Skriptprojekt kann ein Standardprojekt verwenden, das von Apps Script automatisch erstellt wird, oder ein Standardprojekt, das Sie selbst erstellen. Im Allgemeinen eignen sich Standardprojekte für alltägliche oder einfache Skripts. Sie sollten jedoch ein Standardprojekt für eine Anwendung verwenden, die komplex und kommerziell ist oder die Sie veröffentlichen möchten.

Sie können jederzeit von einem Standardprojekt zu einem Standardprojekt wechseln, aber nicht zurück zu einem Standardprojekt. Am besten wählen Sie das Cloud-Projekt aus, das Ihr Skript zu Beginn der Entwicklung verwendet. Ein späterer Wechsel kann zu Komplikationen führen, z. B. wenn Nutzer noch einmal autorisiert werden müssen.

Cloud-Standardprojekte

Wenn Sie ein Apps Script-Projekt erstellen, erstellt Apps Script ein Cloud-Standardprojekt, das im Hintergrund ausgeführt wird.

  • Bei den meisten Skripts müssen Sie dieses Standardprojekt nie ansehen oder anpassen. Apps Script übernimmt die erforderlichen Interaktionen mit Google Cloud. Wenn Sie beispielsweise einen erweiterten Dienst im Apps Script-Editor aktivieren, aktiviert Apps Script den erweiterten Dienst im Cloud-Standardprojekt, wenn Sie das Skriptprojekt speichern.
  • Bei einigen Skripts müssen Sie mit der Google Cloud Console interagieren. In diesen Fällen muss das Skript stattdessen ein Cloud-Standardprojekt verwenden. Wenn Sie beispielsweise Google Cloud-Logs in der Google Cloud Console ansehen möchten, muss Ihr Skript ein Standardprojekt verwenden.

Standardmäßig haben Cloud-Projekte eine IAM-Richtlinie (Identity and Access Management) mit einem Eintrag, einem Google-Dienstkonto, das als Inhaber des Standardprojekts fungiert. Das Google-Dienstkonto ist appsdev-apps-dev-script-auth@system.gserviceaccount.com.

Cloud-Standardprojekte ansehen oder aktualisieren

Die meisten Nutzer können Standardprojekte in der Google Cloud Console nicht direkt suchen, ansehen oder bearbeiten. Wenn Sie Administrator sind, finden Sie im Hilfeartikel Google Cloud-Standardprojekte ansehen weitere Informationen.

Wenn Sie Ihr Skriptprojekt vor dem 8. April 2019 erstellt haben, können Sie ein Standardprojekt verwenden, auf das Sie in der Google Cloud Console zugreifen können. Wenn Sie auf das Standardprojekt zugreifen möchten, rufen Sie die Einstellungen des Skriptprojekts auf und klicken Sie auf die Projektnummer.

Cloud-Standardprojekte löschen

Als Administrator können Sie Cloud-Standardprojekte wie Cloud-Standardprojekte löschen. Siehe Apps Script-Cloud-Projekte löschen.

Wenn Sie kein Administrator sind, können Sie keine Standardprojekte löschen. In folgenden Fällen werden jedoch Apps Script gelöscht:

  • Wenn Sie das Skriptprojekt löschen oder zu einem Standardprojekt wechseln, löscht Apps Script das an das Skript angehängte Standardprojekt und alle darin enthaltenen Einstellungen oder Informationen.
  • Wenn ein Skript 180 Tage oder länger nicht ausgeführt wird, löscht Apps Script das zugehörige Standardprojekt. Wenn das Skript ausgeführt wird, nachdem Apps Script sein Standardprojekt gelöscht hat, erstellt Apps Script eines für das Skript.

Cloud-Standardprojekte

Cloud-Standardprojekte sind für die meisten Skriptprojekte die beste Wahl, es sei denn, Sie müssen das Projekt manuell konfigurieren. In diesen Fällen müssen Sie das Skriptprojekt umstellen.

In den folgenden Abschnitten wird beschrieben, wann Apps Script ein Standardprojekt erfordert. Außerdem werden die Eigenschaften solcher Projekte und häufige damit verbundene Aufgaben beschrieben. Sie können die folgenden Aufgaben nur mit Standardprojekten ausführen.

Wenn Apps Script Standard-Cloud-Projekte erfordert

In den folgenden Situationen müssen Sie ein Standardprojekt verwenden:

Standardattribute für Cloud-Projekte

Standardprojekte haben folgende Attribute:

  • Sie können direkt über die Google Cloud Console auf alle Google Cloud-Einstellungen für das Projekt zugreifen. Auf diese Weise können Sie APIs aktivieren, Anmeldedaten für die Autorisierung anpassen und andere Details konfigurieren.
  • Wenn Sie ein Skriptprojekt löschen oder zu einem anderen Standardprojekt wechseln, bleibt das ursprüngliche Standardprojekt bestehen und kann wiederverwendet werden.
  • Wenn Sie einen erweiterten Dienst in einem Skriptprojekt aktivieren, müssen Sie die entsprechende API im Standardprojekt manuell aktivieren.
  • Mehrere Skriptprojekte und andere Anwendungen können dasselbe Standardprojekt verwenden. Wenn Sie ein Skriptprojekt im Google Workspace Marketplace als Add-on veröffentlichen möchten, muss es ein eigenes Standardprojekt haben. Veröffentlichte Anwendungen können keine Cloud-Projekte mit anderen Anwendungen teilen.
  • Wenn Sie Funktionen in einem Skriptprojekt aus einer anderen Anwendung mithilfe der Methode scripts.run der Apps Script API ausführen möchten, müssen das Skriptprojekt und die aufrufende Anwendung dasselbe Standardprojekt verwenden.
  • Wenn ein Nutzer von Apps Script dazu aufgefordert wird, ein Skript zu autorisieren, das ein Standardprojekt verwendet, wird der Name des Cloud-Projekts verwendet, um das Skript zu identifizieren (nicht der Name des Skriptprojekts). Legen Sie daher unbedingt einen geeigneten Cloud-Projektnamen fest.

Auf ein Cloud-Standardprojekt zugreifen

So greifen Sie auf das mit Ihrem Skriptprojekt verbundene Standardprojekt zu:

  1. Öffnen Sie das Apps Script-Projekt.
  2. Klicken Sie links auf Projekteinstellungen .
  3. Klicken Sie unter Google Cloud Platform-Projekt (GCP-Projekt) auf die Projektnummer.

Sie finden ein Standardprojekt auch direkt auf der Seite Google Cloud Console Ressourcen verwalten.

API in einem Cloud-Standardprojekt aktivieren

Häufig benötigt eine Apps Script-Anwendung Zugriff auf eine andere Google API. Dazu müssen Sie die API im entsprechenden Cloud-Projekt aktivieren. So aktivieren Sie eine API:

  1. Öffnen Sie das Cloud-Projekt.
  2. Klicken Sie auf das Dreistrich-Menü > APIs und Dienste.
  3. Klicken Sie auf APIs und Dienste aktivieren.
  4. Geben Sie im Suchfeld die API ein, die Sie aktivieren möchten, und drücken Sie die Eingabetaste.
  5. Klicken Sie in den Suchergebnissen auf die API und dann auf Aktivieren, um die API für dieses Cloud-Projekt zu aktivieren.

Sie werden möglicherweise aufgefordert, die Nutzungsbedingungen für Google APIs oder Google Cloud zu akzeptieren. Lesen Sie die Nutzungsbedingungen sorgfältig durch, bevor Sie sie akzeptieren.

Je nach Anwendung müssen Sie die API möglicherweise konfigurieren, indem Sie sie im Dashboard APIs und Dienste auswählen.

ID und Nummer eines Cloud-Standardprojekts ermitteln

Alle Cloud-Projekte haben einen Projektnamen, eine Projekt-ID und eine Projektnummer. Gelegentlich benötigen Sie diese IDs, um Dienste zu konfigurieren oder andere Aufgaben auszuführen.

So ermitteln Sie die ID und die Nummer Ihres Standardprojekts:

  1. Öffnen Sie das Cloud-Projekt.
  2. Klicken Sie rechts oben auf das Dreipunkt-Menü > Projekteinstellungen.
  3. Sehen Sie sich im Bereich Einstellungen den Projektnamen, die Projekt-ID und die Projektnummer an. Die Projektnummer besteht nur aus Ziffern, während die Projekt-ID alphanumerisch ist. Sie können den Projektnamen bearbeiten, der Nutzern bei Aufforderungen zur Autorisierung angezeigt wird.

Google Cloud-Logs und Fehlerberichte in der Google Cloud Console ansehen

Wenn Sie Google Cloud-Logging oder Fehlerberichte für Ihr Skriptprojekt verwenden, können Sie diese Logs und Berichte in der Google Cloud Console so aufrufen:

  1. Öffnen Sie das Cloud-Projekt.
  2. Klicken Sie auf das Dreistrich-Menü .
  3. Scrollen Sie nach unten zum Abschnitt Vorgänge und klicken Sie auf Logging > Log-Explorer.
  4. Scrollen Sie zum Abschnitt Vorgänge und klicken Sie auf Fehlerberichte, um Fehlerberichte aufzurufen. Wenn Sie aufgefordert werden, Error Reporting einzurichten, hat Ihr Skriptprojekt noch keine Ausnahmen protokolliert.

Wenn Sie Dienste verwenden, für die OAuth erforderlich ist, werden Nutzer von Google aufgefordert, diese Dienste zu autorisieren. Über die Einstellungen des OAuth-Zustimmungsbildschirms können Sie einige der Informationen festlegen, die Google Nutzern zur Verfügung stellt, z. B. den Anwendungsnamen und die URL der Nutzungsbedingungen.

Cloud-Standardprojekte erstellen automatisch einen Zustimmungsbildschirm aus den Apps Script-Projektdetails. Diese Einstellungen können Sie nicht anpassen. Mit Cloud-Standardprojekten können Sie diese Informationen anpassen. So konfigurieren Sie den Zustimmungsbildschirm Ihres Skripts:

  1. Öffnen Sie das Cloud-Projekt.
  2. Klicken Sie auf das Dreistrich-Menü > APIs und Dienste > Anmeldedaten.
  3. Klicken Sie auf Zustimmungsbildschirm konfigurieren.
  4. Füllen Sie alle Abschnitte des Workflows auf dem Zustimmungsbildschirm aus.
  5. Klicken Sie zum Aufzeichnen der Änderungen in jeder Phase des Workflows auf Speichern und fortfahren.

OAuth-Anmeldedaten erstellen

Apps Script richtet OAuth normalerweise für die Dienste ein, die Ihr Skript verwendet. Für einige Anwendungen müssen Sie zusätzliche OAuth-Anmeldedaten (Client-IDs und Clientschlüssel) erstellen. Dies ist nur mit Standardprojekten möglich.

So erstellen Sie eine Client-ID und einen Clientschlüssel für Ihr Skriptprojekt:

  1. Öffnen Sie das Cloud-Projekt.
  2. Klicken Sie auf das Dreistrich-Menü > APIs und Dienste > Anmeldedaten.
  3. Klicken Sie auf Anmeldedaten erstellen > OAuth-Client-ID.
  4. Wählen Sie unter Anwendungstyp den Anwendungstyp aus und füllen Sie gegebenenfalls das resultierende Formular aus. Klicken Sie abschließend auf Erstellen.
  5. Klicken Sie im angezeigten Dialogfeld auf JSON herunterladen. Mit dieser Datei können Sie OAuth konfigurieren.

Einem Cloud-Standardprojekt zusätzliche Inhaber hinzufügen

Sie können einem Standardprojekt weitere Inhaber oder andere Rollen hinzufügen. Wenn Sie gemeinsam an einem Projekt arbeiten, können Sie dafür sorgen, dass immer ein Mitglied Ihres Teams Zugriff auf die Google Cloud-Einstellungen des Skriptprojekts hat.

Sie können einem Standardprojekt zusätzliche Inhaber oder andere Rollen hinzufügen. Gehen Sie dazu so vor: Sie benötigen Bearbeitungsberechtigungen für das Projekt, um diese Änderungen vorzunehmen:

  1. Legen Sie fest, wer Ihre Mitbearbeiter sein sollen. Wir empfehlen Ihnen, eine vorhandene Google-Gruppe zu erstellen oder zu verwenden. Sie können in der Liste der Mitbearbeiter auch Domains angeben, um alle Nutzer in dieser Domain einzubeziehen.
  2. Öffnen Sie das Cloud-Projekt des Skripts.
  3. Klicken Sie auf das Dreistrich-Menü > IAM und Verwaltung > IAM.
  4. Klicken Sie oben auf Hinzufügen.
  5. Folgen Sie der Anleitung auf dem Bildschirm, um dem Cloud-Projekt ein oder mehrere neue Mitglieder und ihre Rollen hinzuzufügen. Sie können einzelne E-Mails, Google Groups-Gruppen oder Domains als neue Mitglieder hinzufügen.
  6. Klicken Sie auf Speichern.

Mehrere Skripts mit einem einzigen Cloud-Projekt gruppieren

Es können mehrere Apps Script-Projekte über dasselbe Cloud-Standardprojekt verfügen. Erstellen Sie dazu ein Standardprojekt und wechseln Sie dann jedes Skriptprojekt zu diesem Projekt. Mit Standardprojekten ist dies nicht möglich.

Anderes Cloud-Standardprojekt verwenden

Sie können ein Skriptprojekt ändern, sodass ein anderes Cloud-Standardprojekt verwendet wird. Wenn Ihr Skript eine manuelle Konfiguration des Cloud-Projekts erfordert, müssen Sie von einem Standardprojekt zu einem Standardprojekt wechseln. Weitere Informationen zur Verwendung eines Standardprojekts finden Sie unter Cloud-Standardprojekte.

Auswirkungen des Wechsels zu einem anderen Cloud-Standardprojekt

Wenn Sie Ihr Skript von einem Standardprojekt oder einem anderen Standardprojekt umstellen, hat das folgende Auswirkungen:

  • Wenn Sie erweiterte Dienste für Ihr Skript aktiviert haben, müssen Sie die entsprechenden APIs im neuen Cloud-Projekt aktivieren. Alle mit den erweiterten Diensten im vorherigen Cloud-Projekt verbundenen Daten gehen verloren. Informationen zum Aktivieren von APIs in Ihrem Cloud-Projekt finden Sie unter Google Workspace APIs aktivieren.
  • Alle Nutzer, die das Skript zuvor autorisiert haben, müssen es noch einmal autorisieren. In den meisten Fällen müssen auch alle Nutzer, die zuvor autorisierte Apps für das neue Projekt autorisiert haben, neu autorisiert werden.
  • Wenn Ihr Skript mit einem App-Eintrag im Google Workspace Marketplace verknüpft ist, werden Ihr App-Eintrag, Ihre Nutzer und Rezensionen nicht in das neue Projekt übernommen. Sie müssen einen App-Eintrag im neuen Projekt erstellen und Ihre Nutzer müssen die App neu installieren. Informationen zum Erstellen eines neuen App-Eintrags finden Sie unter App veröffentlichen.
  • Sie können ein Skript nicht wieder auf ein Standardprojekt zurücksetzen. Apps Script löscht Standardprojekte, nachdem Sie das Skript für die Verwendung eines Standardprojekts festgelegt haben.

Zu einem anderen Cloud-Standardprojekt wechseln

So wechseln Sie das vorhandene Cloud-Projekt eines Skripts zu einem anderen Cloud-Projekt:

  1. Wenn Sie kein geeignetes Cloud-Projekt haben, folgen Sie der Anleitung unter Projekt erstellen. Legen Sie einen einprägsamen Projektnamen fest, damit Sie ihn in der Seite Ressourcen verwalten der Google Cloud Console finden können. Apps Script verwendet diesen Namen, wenn Nutzer aufgefordert werden, das Skript zu autorisieren.
  2. Wenn Sie ein vorhandenes Projekt verwenden möchten, öffnen Sie die Seite Ressourcen verwalten der Google Cloud Console und suchen Sie ein vorhandenes Projekt. Sie benötigen die Rollen „Projektbrowser“ und „OAuth-Konfigurationsbearbeiter“ oder Rollen mit den entsprechenden Berechtigungen für das Projekt. Sie können kein Projekt verwenden, das automatisch von Apps Script erstellt wurde.
  3. Bestimmen Sie die Projektnummer Ihres Cloud-Projekts.
  4. Öffnen Sie das Skript, dessen Cloud-Projekt Sie ersetzen möchten.
  5. Klicken Sie links auf Projekteinstellungen .
  6. Klicken Sie unter Google Cloud Platform-Projekt (GCP-Projekt) auf Projekt ändern.
  7. Geben Sie die neue Projektnummer ein und klicken Sie auf Projekt festlegen.

Cloud-Projekte und geteilte Ablagen

Geteilte Ablagen (ehemals Teamablagen) sind gemeinsam nutzbare Bereiche, in denen Drive-Nutzergruppen an Apps Script-Projekten und Drive-Dokumenten arbeiten können. Geteilte Ablagen sind hilfreich, wenn Sie einem Team Skripts, Add-ons und Webanwendungen entwickeln. Sie beschränken jedoch die Möglichkeiten, die Ihnen ältere Cloud-Standardprojekte bieten.

In der folgenden Liste der Einschränkungen wird beschrieben, wie Cloud-Projekte mit geteilten Ablagen interagieren:

  • Wenn Ihr Skriptprojekt ein Standardprojekt verwendet, gibt es keine zusätzlichen Einschränkungen, wenn sich das Skriptprojekt in einer geteilten Ablage befindet.
  • Wenn Ihr Skriptprojekt ein Standardprojekt verwendet, das am oder nach dem 8. April 2019 erstellt wurde, gibt es keine zusätzlichen Einschränkungen, wenn sich das Skriptprojekt in einer geteilten Ablage befindet.
  • Wenn Ihr Skriptprojekt ein Standardprojekt verwendet, das vor dem 8. April 2019 erstellt wurde, gelten die folgenden Einschränkungen, während sich das Skriptprojekt in einer geteilten Ablage befindet:
    1. Sie können nicht über die Apps Script-UI oder die Google Cloud Console auf das Standardprojekt zugreifen. Diese Einschränkung verhindert, dass Sie Aktionen ausführen können, die direkten Zugriff auf das Projekt erfordern.
    2. Sie können erweiterte Dienste nicht aktivieren. Wechseln Sie zu einem Standardprojekt, um erweiterte Dienste zu aktivieren.
    3. Wenn Sie ein vorhandenes Apps Script-Projekt in eine geteilte Ablage verschieben, schränkt Google den Zugriff auf das Cloud-Standardprojekt ein. Sie können weiterhin auf das Standardprojekt zugreifen, wenn Sie zuvor Zugriff hatten. Wenn Sie beispielsweise ein Skript im Ordner „Meine Ablage“ erstellt und es anschließend in eine geteilte Ablage verschoben haben, können Sie weiterhin auf das Cloud-Projekt des Skripts zugreifen. Ihre Mitbearbeiter in der geteilten Ablage können dies möglicherweise nicht.
    4. Ein Skript behält den Namen des Cloud-Projekts bei, bevor es in eine geteilte Ablage verschoben wurde. Auch wenn Sie den Projektnamen in der geteilten Ablage ändern, sehen Nutzer, die das Skript autorisieren, weiterhin den alten Namen in den Autorisierungsdialogen.

Wechseln Sie zu einem Standardprojekt, um die oben genannten Einschränkungen für ältere Skripts zu vermeiden.

Liste der Apps Script-Cloud-Projekte abrufen

Wenn Sie die Berechtigung resourcemanager.projects.list für den Apps Script-Projektordner Ihrer Organisation haben, können Sie alle Standard- und Standard-Apps Script-Cloud-Projekte im Ordner aufrufen.

  1. Öffnen Sie die Seite Ressourcen verwalten der Google Cloud Console.
  2. Kopieren Sie die ID neben dem Ordner Apps Script.
  3. Klicken Sie auf Filter > Übergeordnete ID und fügen Sie die Apps Script-Ordner-ID ein.

Apps Script Cloud-Projekte löschen

Führen Sie zum Löschen eines Apps Script Cloud-Projekts die Schritte unter Liste der Apps Script Cloud-Projekte abrufen aus, wählen Sie das Projekt aus, das Sie löschen möchten, und klicken Sie auf Löschen.

Verwenden Sie die folgenden Befehle, um ein Apps Script-Projekt mit gcloud zu löschen.

gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID

Weitere Informationen zum Löschen von Cloud-Projekten finden Sie unter Projekte beenden (löschen).