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 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 eine komplexe, kommerzielle Qualität hat oder die Sie veröffentlichen möchten.

Sie können jederzeit von einem Standardprojekt zu einem Standardprojekt wechseln, aber nicht zu einem Standardprojekt zurückwechseln. Es empfiehlt sich, das von Ihrem Skript verwendete Cloud-Projekt frühzeitig in der Entwicklung auszuwählen. Ein späterer Wechsel kann zu Komplikationen führen, z. B. eine nochmalige Autorisierung durch Ihre Nutzer.

Cloud-Standardprojekte

Wenn Sie ein Apps Script-Projekt erstellen, erstellt Apps Script ein standardmäßiges Cloud-Projekt, 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 das Skript stattdessen ein Standard-Cloud-Projekt verwenden. Wenn Sie beispielsweise Google Cloud-Logs in der Google Cloud Console ansehen 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 suchen, 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 Standard-Cloud-Projekte löschen. Weitere Informationen finden Sie unter Apps Script-Cloud-Projekte löschen.

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

  • Wenn Sie das Skriptprojekt löschen oder es auf die Verwendung eines Standardprojekts umstellen, löscht Apps Script das an das Skript angehängte Standardprojekt zusammen mit allen darin enthaltenen Einstellungen oder Informationen.
  • Wenn ein Script 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 eines 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 erfordert, die Eigenschaften 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 Standard-Cloud-Projekte 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, die 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 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 gemeinsam nutzen. 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 für andere Anwendungen freigeben.
  • Wenn Sie Funktionen in einem Skriptprojekt aus einer anderen App mithilfe der scripts.run-Methode 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 mit dem Skriptprojektnamen. Aus diesem Grund müssen Sie einen geeigneten Cloud-Projektnamen festlegen.

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 können ein Standardprojekt auch direkt in der Google Cloud Console auf der Seite Ressourcen verwalten finden.

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, indem Sie sie im Dashboard APIs & 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 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. Sehen Sie sich im entsprechenden Bereich Einstellungen den Projektnamen, die Projekt-ID und die Projektnummer an. Die Projektnummer besteht nur aus Ziffern, die Projekt-ID hingegen 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 aufgefordert werden, Error Reporting einzurichten, bedeutet dies, dass in Ihrem Skriptprojekt noch keine Ausnahmen protokolliert wurden.

Wenn Sie Dienste verwenden, die OAuth erfordern, fordert Google die Nutzer auf, diese Dienste zu autorisieren. In den Einstellungen des OAuth-Zustimmungsbildschirms kannst du 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 für den Zustimmungsbildschirm aus.
  5. Klicken Sie zum Erfassen Ihrer Änderungen in jeder Phase des Workflows auf Speichern und fortfahren.

OAuth-Anmeldedaten erstellen

Mit Apps Script wird normalerweise OAuth für die Dienste eingerichtet, 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 resultierende Formular aus. Wenn Sie fertig sind, klicken Sie auf Erstellen.
  5. Klicken Sie im angezeigten Dialogfeld auf JSON herunterladen. Sie können diese Datei verwenden, um OAuth zu 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, sorgt dies dafür, 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 vorzunehmen:

  1. Bestimmen Sie, wer Ihre Mitbearbeiter sind. Wir empfehlen, 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 ein gemeinsames Cloud-Standardprojekt durch mehrere Apps Script-Projekte einrichten. Dazu erstellen Sie ein Standardprojekt und ändern dann jedes Skriptprojekt, um es zu verwenden. Mit 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 Ihr 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 einem anderen Standardprojekt ändern, 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. Sie verlieren alle Daten, die im vorherigen Cloud-Projekt mit den erweiterten Diensten verknüpft waren. Informationen zum Aktivieren von APIs in Ihrem Cloud-Projekt finden Sie unter Google Workspace APIs aktivieren.
  • Wenn das 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 sich alle Nutzer, die zuvor mit dem neuen Projekt verknüpfte Apps autorisiert haben, ebenfalls noch einmal autorisieren.
  • Wenn Ihr Script mit einem App-Eintrag im Google Workspace Marketplace verknüpft ist, werden Ihr App-Eintrag, Ihre Nutzer und Ihre 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.
  • Ein Skript kann nicht wieder in ein Standardprojekt umgewandelt werden. Mit Apps Script werden Standardprojekte gelöscht, nachdem Sie für das Script die Verwendung eines Standardprojekts festgelegt haben.

Zu einem anderen Cloud-Standardprojekt wechseln

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

  1. Falls 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 finden. Apps Script verwendet diesen Namen, wenn Nutzer aufgefordert werden, das Script 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 gemeinsam genutzte 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 ein, die Sie mit älteren Cloud-Standardprojekten ausführen können.

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, 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 in einer geteilten Ablage befindet:
    1. Der Zugriff auf das Standardprojekt ist über die Apps Script-UI oder die Google Cloud Console nicht möglich. Sie können dann 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 vorhandenes Apps Script-Projekt in eine geteilte Ablage verschieben, schränkt Google den Zugriff auf das Cloud-Standardprojekt ein. Wenn Sie vor dem Verschieben Zugriff hatten, können Sie weiterhin auf das Standardprojekt zugreifen. Wenn Sie beispielsweise ein Skript im Ordner „Meine Ablage“ erstellt und dann 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 das möglicherweise nicht.
    4. Ein Script 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 Autorisierungsdialogen weiterhin den alten Namen.

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 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 > ID des übergeordneten Elements und fügen Sie die Apps Script-Ordner-ID ein.

Apps Script-Cloud-Projekte löschen

Um ein Apps Script-Cloud-Projekt zu löschen, führen Sie 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).