Google Cloud-Projekte

Jedes Apps Script-Projekt verwendet Google Cloud, 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 Standardprojekt verwenden, das von Apps Script automatisch erstellt wird, oder ein Standardprojekt, das Sie selbst erstellen. Standardprojekte eignen sich im Allgemeinen für alltägliche oder einfache Skripts. Sie sollten jedoch ein Standardprojekt für jede Anwendung verwenden, die komplex ist oder eine kommerzielle Qualität aufweist 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 wechseln. Es empfiehlt sich, das von Ihrem Skript verwendete Cloud-Projekt früh in der Entwicklung auszuwählen. Ein späterer Wechsel kann zu Komplikationen führen, z. B. dass Ihre Nutzer sich noch einmal autorisieren 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 aufrufen oder anpassen. Apps Script übernimmt die erforderlichen Interaktionen mit Google Cloud. Wenn Sie beispielsweise im Apps Script-Editor einen erweiterten Dienst 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 aufrufen möchten, muss Ihr Skript ein Standardprojekt verwenden.

Cloud-Projekte haben standardmäßig 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 finden, ansehen oder bearbeiten. Wenn Sie Administrator sind, lesen Sie den Hilfeartikel Google Cloud-Standardprojekte ansehen.

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. Um auf das Standardprojekt zuzugreifen, rufen Sie die Einstellungen des Skriptprojekts auf und klicken Sie auf die Projektnummer.

Cloud-Standardprojekte löschen

Als Administrator können Sie Cloud-Standardprojekte genau wie standardmäßige Cloud-Projekte löschen. Weitere Informationen finden Sie unter Apps Script-Cloud-Projekte löschen.

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

  • Wenn Sie das Skriptprojekt löschen oder auf ein Standardprojekt umstellen, löscht Apps Script das an das Skript angehängte 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 das Standardprojekt gelöscht hat, erstellt Apps Script ein Projekt für das Skript.

Cloud-Standardprojekte

Cloud-Standardprojekte sind die beste Option für die meisten Skriptprojekte, 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, die Attribute solcher Projekte und häufige Aufgaben, die damit ausgeführt werden. Sie können die folgenden Aufgaben nur mit Standardprojekten ausführen.

Wenn Apps Script Cloud-Standardprojekte erfordert

In 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 es auf ein anderes Standardprojekt umstellen, bleibt das ursprüngliche Standardprojekt erhalten und kann wiederverwendet werden.
  • Wenn Sie in einem Skriptprojekt einen erweiterten Dienst 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 mit der scripts.run-Methode der Apps Script API Funktionen in einem Skriptprojekt von einer anderen Anwendung aus 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 der Name des Cloud-Projekts zur Identifizierung des Skripts verwendet (nicht der Skriptprojektname). Legen Sie daher unbedingt einen geeigneten Cloud-Projektnamen fest.

Auf ein standardmäßiges Cloud-Projekt 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.

Möglicherweise werden Sie 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. Wählen Sie sie dazu 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 Kennungen, 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. Rufen Sie im daraufhin angezeigten Bereich Einstellungen den Projektnamen, die Projekt-ID und die Projektnummer auf. Die Projektnummer besteht nur aus Ziffern, die Projekt-ID hingegen ist alphanumerisch. Sie können den Projektnamen bearbeiten, der Nutzern bei Autorisierungsaufforderungen angezeigt wird.

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

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

Wenn Sie Dienste verwenden, für die OAuth erforderlich ist, werden Nutzer von Google aufgefordert, 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.

In Cloud-Standardprojekten wird automatisch ein Zustimmungsbildschirm aus den Apps Script-Projektdetails erstellt. Diese Einstellungen können nicht geändert werden. In Standard-Cloud-Projekten 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 die einzelnen Abschnitte des Workflows aus dem Zustimmungsbildschirm aus.
  5. Klicken Sie auf Speichern und fortfahren, um Ihre Änderungen in jeder Phase des Workflows zu erfassen.

OAuth-Anmeldedaten erstellen

Mit Apps Script wird in der Regel OAuth für die Dienste eingerichtet, die Ihr Skript verwendet. Für einige Anwendungen müssen zusätzliche OAuth-Anmeldedaten (Client-IDs und Clientschlüssel) erstellt werden. 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 Ihren Anwendungstyp aus und füllen Sie bei Bedarf 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 zusätzliche Inhaber oder andere Rollen hinzufügen. Wenn Sie an einem Projekt zusammenarbeiten, können Sie so dafür sorgen, dass immer jemand in Ihrem Team 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 folgende Änderungen vornehmen zu können:

  1. Bestimmen Sie, wer Ihre Mitbearbeiter sind. Es wird empfohlen, eine Google-Gruppe zu erstellen oder eine vorhandene zu verwenden. Sie können auch Domains in der Liste der Mitbearbeiter angeben, um alle Nutzer in dieser Domain einzubeziehen.
  2. Öffnen Sie das Cloud-Projekt des Skripts.
  3. Klicken Sie auf das Dreistrich-Menü > IAM & 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-Mail-Adressen, Google-Gruppen oder Domains als neue Mitglieder hinzufügen.
  6. Klicken Sie auf Speichern.

Mehrere Skripts mit einem einzigen Cloud-Projekt gruppieren

Sie können mehrere Apps Script-Projekte in einem Cloud-Standardprojekt verwenden. Dazu erstellen Sie ein Standardprojekt und wechseln dann jedes Skriptprojekt, um es zu verwenden. Bei Standardprojekten ist dies nicht möglich.

Anderes Cloud-Standardprojekt verwenden

Sie können ein Skriptprojekt so ändern, dass es ein anderes Cloud-Standardprojekt verwendet. Wenn für Ihr Skript eine manuelle Konfiguration des Cloud-Projekts erforderlich ist, 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 einem anderen Standardprojekt ändern, 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. Sie verlieren alle Daten, 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 das Skript noch einmal autorisieren. In den meisten Fällen müssen sich alle Nutzer, die zuvor mit dem neuen Projekt verknüpfte Apps autorisiert haben, ebenfalls noch einmal autorisieren.
  • 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 innerhalb des neuen Projekts einen App-Eintrag 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 in ein Standardprojekt zurückversetzen. Mit Apps Script werden Standardprojekte gelöscht, nachdem Sie für das Skript die Verwendung eines Standardprojekts festgelegt haben.

Zu einem anderen Cloud-Standardprojekt wechseln

So stellen Sie ein vorhandenes Cloud-Projekt eines Skripts in ein anderes Cloud-Projekt um:

  1. Wenn Sie kein geeignetes Cloud-Projekt haben, erstellen Sie eines. Folgen Sie dazu der Anleitung unter Projekt erstellen. Legen Sie einen einprägsamen Projektnamen fest, den Sie in der Google Cloud Console auf der Seite Ressourcen verwalten finden. 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. Für das Projekt benötigen Sie 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) auf Projekt ändern.
  7. Geben Sie die neue Projektnummer ein und klicken Sie auf Projekt festlegen.

Cloud-Projekte und geteilte Ablagen

Geteilte Ablagen (früher Teamablagen) bieten 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. Sie schränken jedoch die Möglichkeiten mit älteren Cloud-Standardprojekten ein.

In der folgenden Liste mit 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, gelten 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, die einen 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 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 vor dem Verschieben Zugriff hatten. Wenn Sie beispielsweise ein Skript im Ordner „Meine Ablage“ erstellt und dann in eine geteilte Ablage verschoben haben, können Sie weiterhin auf das Cloudprojekt des Skripts zugreifen. Die Mitbearbeiter in der geteilten Ablage können das 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 der geteilten Ablage ändern, sehen Nutzer, die das Skript autorisieren, in den Autorisierungsdialogfeldern weiterhin den alten Namen.

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

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 in diesem 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).