Google Cloud-Projekte

Für jedes Apps Script-Projekt wird Google Cloud verwendet, um die Autorisierung, 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 von Apps Script automatisch erstelltes Standardprojekt oder ein von Ihnen selbst erstelltes Standardprojekt verwenden. Im Allgemeinen eignen sich Standardprojekte für alltägliche oder einfache Skripts. Sie sollten jedoch ein Standardprojekt für jede Anwendung verwenden, die komplex ist oder kommerzielle Qualität hat oder die Sie veröffentlichen möchten.

Sie können jederzeit von einem Standardprojekt zu einem Standardprojekt wechseln. Es ist jedoch nicht möglich, wieder zum Standardprojekt zu wechseln. Es empfiehlt sich, das Cloud-Projekt, das Ihr Skript verwendet, frühzeitig in der Entwicklung auszuwählen. Ein späterer Wechsel kann zu Problemen führen, z. B. dass Nutzer sich noch einmal autorisieren müssen.

Cloud-Standardprojekte

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

  • Bei den meisten Skripts müssen Sie dieses Standardprojekt nie sehen 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 Ihr 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. Weitere Informationen für Administratoren finden Sie im Hilfeartikel Google Cloud-Standardprojekte ansehen.

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

Cloud-Standardprojekte löschen

Als Administrator können Sie Cloud-Standardprojekte wie Cloud-Standardprojekte löschen. Weitere Informationen finden Sie unter Cloud-Projekte in Apps Script löschen.

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

  • Wenn Sie das Skriptprojekt löschen oder auf ein Standardprojekt umstellen, löscht Apps Script das mit dem Skript verknüpfte Standardprojekt zusammen mit allen 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 ein Projekt für das Skript.

Cloud-Standardprojekte

Cloud-Standardprojekte sind für die meisten Skriptprojekte die beste Option, es sei denn, Sie müssen das Projekt manuell konfigurieren. In diesen Situationen müssen Sie Ihr Skriptprojekt auf ein Standardprojekt umstellen.

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

Wenn Apps Script Cloud-Standardprojekte erfordert

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

Standard-Cloud-Projektattribute

Standardprojekte haben die folgenden Attribute:

  • Sie können direkt über die Google Cloud Console auf alle Google Cloud-Einstellungen für das Projekt zugreifen. So können Sie APIs aktivieren, Anmeldedaten für die Autorisierung anpassen und andere Details konfigurieren.
  • Wenn Sie ein Skriptprojekt löschen oder auf ein anderes Standardprojekt umstellen, bleibt das ursprüngliche Standardprojekt erhalten und kann wiederverwendet werden.
  • Wenn Sie einen erweiterten Dienst in einem Skriptprojekt aktivieren, müssen Sie die entsprechende API im Standardprojekt manuell aktivieren.
  • Ein Standardprojekt kann von mehreren Skriptprojekten und anderen Anwendungen gemeinsam verwendet werden. Wenn Sie ein Skriptprojekt als Add-on im Google Workspace Marketplace veröffentlichen möchten, muss es ein eigenes Standardprojekt haben. Veröffentlichte Apps können Cloud-Projekte nicht für andere Apps freigeben.
  • Wenn Sie Funktionen in einem Skriptprojekt von einer anderen Anwendung mit der Methode scripts.run der Apps Script API ausführen möchten, müssen sich das Skriptprojekt und die aufrufende Anwendung im selben Standardprojekt befinden.
  • Wenn Apps Script einen Nutzer auffordert, ein Skript zu autorisieren, das ein Standardprojekt verwendet, wird das Skript anhand des Cloud-Projektnamens identifiziert (nicht der Skriptprojektname). Achten Sie daher darauf, einen geeigneten Namen für das Cloud-Projekt festzulegen.

Auf ein Cloud-Standardprojekt zugreifen

So greifen Sie auf das mit Ihrem Skriptprojekt verknüpfte Standardprojekt zu:

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

Sie finden ein Standardprojekt auch direkt in der Google Cloud Console auf der Seite 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 auch konfigurieren. Dazu wählen Sie sie im Dashboard APIs & Dienste aus.

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 Nummer Ihres Standardprojekts:

  1. Öffnen Sie das Cloud-Projekt.
  2. Klicken Sie rechts oben auf das Dreipunkt-Menü > Projekteinstellungen.
  3. Sehen Sie sich im resultierenden 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 Autorisierungsaufforderungen angezeigt wird.

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

Wenn Sie für Ihr Skriptprojekt Google Cloud-Logging oder Fehlerberichte 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 Ansehen von Fehlerberichten nach unten zum Abschnitt Vorgänge und klicken Sie auf Error Reporting. Wenn Sie zum Einrichten von Error Reporting aufgefordert werden, bedeutet dies, dass in Ihrem Skriptprojekt noch keine Ausnahmen protokolliert wurden.

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

Bei standardmäßigen Cloud-Projekten wird automatisch über die Apps Script-Projektdetails ein Zustimmungsbildschirm erstellt. Sie können diese Einstellungen nicht ändern. In 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 jeden Abschnitt des Workflows für den Zustimmungsbildschirm aus.
  5. Klicken Sie auf Speichern und fortfahren, damit Ihre Änderungen in jeder Phase des Workflows erfasst werden.

OAuth-Anmeldedaten erstellen

Apps Script richtet OAuth in der Regel 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 bei Bedarf das entsprechende 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 an einem Projekt zusammenarbeiten, sorgt dies dafür, dass jemand in Ihrem Team immer Zugriff auf die Google Cloud-Einstellungen des Skriptprojekts hat.

So fügen Sie einem Standardprojekt weitere Inhaber oder andere Rollen hinzu: Sie benötigen Bearbeitungsberechtigungen für das Projekt, um diese Änderungen vornehmen zu können:

  1. Bestimme, wer deine Collab-Partner sein sollen. Wir empfehlen, eine Google-Gruppe zu erstellen oder eine vorhandene 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 ein oder mehrere neue Mitglieder und ihre Rollen für das Cloud-Projekt hinzuzufügen. Sie können einzelne E-Mail-Adressen, Google Groups-Gruppen oder Domains als neue Mitglieder hinzufügen.
  6. Klicke auf Speichern.

Mehrere Skripts mit einem einzigen Cloud-Projekt gruppieren

Mehrere Apps Script-Projekte können dasselbe Cloud-Standardprojekt gemeinsam nutzen. Erstellen Sie dazu ein Standardprojekt und wechseln Sie zu jedem Skriptprojekt, um es zu verwenden. Bei Standardprojekten ist dies nicht möglich.

Anderes Cloud-Standardprojekt verwenden

Sie können ein Skriptprojekt so ändern, dass ein anderes Cloud-Standardprojekt verwendet wird. Wenn das Skript eine manuelle Konfiguration des Cloud-Projekts erfordert, müssen Sie von einem Standardprojekt zu einem Standardprojekt wechseln. Weitere Informationen dazu, wann Sie ein Standardprojekt verwenden müssen, finden Sie unter Cloud-Standardprojekte.

Auswirkungen des Wechsels zu einem anderen Cloud-Standardprojekt

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

  • Wenn Sie erweiterte Dienste für Ihr Skript aktiviert haben, müssen Sie die entsprechenden APIs im neuen Cloud-Projekt aktivieren. Dabei gehen alle Daten verloren, die mit den erweiterten Diensten im vorherigen Cloud-Projekt verknüpft sind. Informationen zum Aktivieren von APIs in Ihrem Cloud-Projekt finden Sie unter Google Workspace APIs aktivieren.
  • Wenn Ihr Skript den integrierten Google Drive-Dienst verwendet, müssen Sie die Drive API in Cloud-Standardprojekten aktivieren.

    Aktivieren Sie in Ihrem Cloud-Standardprojekt die Drive API:

    Drive API aktivieren

  • Alle Nutzer, die das Skript zuvor autorisiert haben, müssen sich noch einmal autorisieren. In den meisten Fällen müssen alle Nutzer, die zuvor mit dem neuen Projekt verknüpfte Apps autorisiert haben, sich ebenfalls neu autorisieren.
  • Wenn Ihr Skript mit einem App-Eintrag im Google Workspace Marketplace verknüpft ist, werden Ihr App-Eintrag, die Nutzer und die Rezensionen nicht in das neue Projekt übernommen. Sie müssen im neuen Projekt einen App-Eintrag erstellen und Ihre Nutzer müssen Ihre App neu installieren. Informationen zum Erstellen eines neuen App-Eintrags finden Sie unter App veröffentlichen.
  • Sie können ein Skript nicht zurück in ein Standardprojekt zurücksetzen. Apps Script löscht Standardprojekte, nachdem Sie das Script zur Verwendung eines Standardprojekts konfiguriert haben.

Zu einem anderen Cloud-Standardprojekt wechseln

Gehen Sie so vor, um ein vorhandenes Cloud-Projekt eines Skripts in ein anderes Cloud-Projekt zu verschieben:

  1. Wenn Sie kein geeignetes Cloud-Projekt haben, können Sie eines erstellen. Folgen Sie dazu der Anleitung unter Projekt erstellen. Legen Sie einen einprägsamen Projektnamen fest, damit Sie ihn in der Google Cloud Console auf der Seite Ressourcen verwalten wiederfinden. Apps Script verwendet diesen Namen, wenn Nutzer aufgefordert werden, das Skript zu autorisieren.
  2. Wenn Sie ein vorhandenes Projekt verwenden möchten, öffnen Sie in der Google Cloud Console die Seite Ressourcen verwalten und suchen Sie ein vorhandenes Projekt. Sie benötigen für das Projekt die Rollen „Projektbrowser“ und „OAuth-Konfigurationsbearbeiter“ oder Rollen mit den entsprechenden Berechtigungen. 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 Set Project (Projekt festlegen).

Cloud-Projekte und geteilte Ablagen

Geteilte Ablagen (früher Teamablagen) sind gemeinsame Bereiche, in denen Gruppen von Drive-Nutzern an Apps Script-Projekten und Drive-Dokumenten zusammenarbeiten können. Geteilte Ablagen sind nützlich, wenn Sie Skripts, Add-ons und Webanwendungen mit einem Team entwickeln. Allerdings schränken sie die Möglichkeiten der älteren Cloud-Standardprojekte ein.

In der folgenden Liste von 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, wenn sich das Skriptprojekt auf einer geteilten Ablage befindet:
    1. Über die Apps Script-UI oder die Google Cloud Console können Sie nicht auf das Standardprojekt zugreifen. Durch diese Einschränkung können Sie keine Aktionen ausführen, die direkten Zugriff auf das Projekt erfordern.
    2. Sie können keine erweiterten Dienste aktivieren. Wechseln Sie zu einem Standardprojekt, um erweiterte Dienste zu aktivieren.
    3. Wenn Sie ein bestehendes 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 bereits vor dem Verschieben Zugriff hatten. Wenn Sie beispielsweise ein Skript im Ordner „Meine Ablage“ erstellt und es dann in eine geteilte Ablage verschoben haben, können Sie weiterhin auf das Cloud-Projekt des Skripts zugreifen. Dies ist für die Mitbearbeiter der geteilten Ablage möglicherweise nicht möglich.
    4. Ein Skript behält den Namen des Cloud-Projekts bei, bevor es in eine geteilte Ablage verschoben wurde. Auch wenn Sie den Projektnamen der geteilten Ablage ändern, sehen Nutzer, die das Skript autorisieren, im Autorisierungsdialog weiterhin den alten Namen.

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

Liste mit Apps Script-Cloud-Projekten 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 in dem Ordner ansehen.

  1. Öffnen Sie in der Google Cloud Console die Seite Ressourcen verwalten.
  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

Wenn Sie ein Apps Script Cloud-Projekt löschen möchten, führen Sie die Schritte unter Liste der Apps Script Cloud-Projekte abrufen aus, wählen Sie das zu löschende Projekt aus 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).