Google Cloud-Projekte

In jedem Apps Script-Projekt werden Autorisierungen, erweiterte Dienste und andere Details über Google Cloud verwaltet. Um diese Einstellungen zu konfigurieren und zu verwalten, ist jedem Apps Script-Projekt ein Google Cloud-Projekt zugewiesen. Ihr Skriptprojekt kann ein von Apps Script automatisch erstelltes Standardprojekt oder ein von Ihnen selbst erstelltes Standardprojekt verwenden. Standardprojekte eignen sich in der Regel für alltägliche oder einfache Scripts. Sie sollten jedoch ein Standardprojekt für jede Anwendung verwenden, die komplex ist, 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 ist am besten, das Cloud-Projekt, das für Ihr Script verwendet wird, schon früh in der Entwicklung auszuwählen. Ein späterer Wechsel kann zu Komplikationen führen, z. B. müssen Ihre Nutzer sich dann noch einmal autorisieren.

Standard-Cloud-Projekte

Wenn Sie ein Apps Script-Projekt erstellen, wird in Apps Script ein standardmäßiges Cloud-Projekt erstellt, 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, wird er von Apps Script im Standard-Cloud-Projekt aktiviert, wenn Sie das Scriptprojekt speichern.
  • Bei einigen Scripts müssen Sie mit der Google Cloud Console interagieren. In diesen Fällen muss Ihr Script 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.

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 lautet 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 aufrufen, ansehen oder bearbeiten. Weitere Informationen für Administratoren finden Sie im Hilfeartikel Google Cloud-Standardprojekte ansehen.

Wenn Sie Ihr Script-Projekt vor dem 8. April 2019 erstellt haben, können Sie ein Standardprojekt verwenden, 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.

Standard-Cloud-Projekte löschen

Wenn Sie Administrator sind, können Sie Standard-Cloud-Projekte wie andere Standard-Cloud-Projekte löschen. Weitere Informationen finden Sie unter Apps Script-Cloud-Projekte löschen.

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

  • Wenn Sie das Script-Projekt löschen oder zu einem Standardprojekt wechseln, löscht Apps Script das dem Script zugeordnete Standardprojekt zusammen mit allen darin enthaltenen Einstellungen oder Informationen.
  • Wenn ein Script mindestens 180 Tage lang nicht ausgeführt wird, löscht Apps Script das zugehörige Standardprojekt. Wenn das Script ausgeführt wird, nachdem das Standardprojekt in Apps Script gelöscht wurde, wird in Apps Script ein Projekt für das Script erstellt.

Standard-Cloud-Projekte

Standard-Cloud-Projekte sind die beste Option für die meisten Scriptprojekte, es sei denn, Sie müssen das Projekt manuell konfigurieren. In diesen Fällen müssen Sie Ihr Script-Projekt auf ein Standardprojekt umstellen.

In den folgenden Abschnitten wird beschrieben, wann in Apps Script ein Standardprojekt erforderlich ist, welche Eigenschaften solche Projekte haben und welche Aufgaben damit häufig ausgeführt werden. Die folgenden Aufgaben können nur mit Standardprojekten ausgeführt werden.

Wann für Apps Script Standard-Cloud-Projekte erforderlich sind

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

Standard-Cloud-Projektattribute

Standardprojekte haben folgende Eigenschaften:

  • 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, Autorisierungsdaten anpassen und andere Details konfigurieren.
  • Wenn Sie ein Scriptprojekt löschen oder ein anderes Standardprojekt verwenden, bleibt das ursprüngliche Standardprojekt erhalten und kann wiederverwendet werden.
  • Wenn Sie einen erweiterten Dienst in einem Scriptprojekt aktivieren, müssen Sie die entsprechende API im Standardprojekt manuell aktivieren.
  • Mehrere Scriptprojekte und andere Apps können dasselbe Standardprojekt verwenden. Wenn Sie ein Skriptprojekt als Add-on im Google Workspace Marketplace veröffentlichen möchten, muss es ein eigenes Standardprojekt haben. Bei veröffentlichten Apps können keine Cloud-Projekte für andere Apps freigegeben werden.
  • Wenn Sie Funktionen in einem Script-Projekt über die scripts.run-Methode der Apps Script API von einer anderen App aus ausführen möchten, müssen das Script-Projekt und die aufrufende Anwendung dasselbe Standardprojekt verwenden.
  • Wenn in Apps Script ein Nutzer aufgefordert wird, ein Script zu autorisieren, das ein Standardprojekt verwendet, wird das Script anhand des Cloud-Projektnamens und nicht des Namens des Script-Projekts identifiziert. Achten Sie daher darauf, einen geeigneten Namen für das Cloud-Projekt festzulegen.

Auf ein Standard-Cloud-Projekt zugreifen

So greifen Sie auf das Standardprojekt zu, das mit Ihrem Scriptprojekt verknüpft ist:

  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 Standard-Cloud-Projekt aktivieren

Oft 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 & Dienste.
  3. Klicken Sie auf APIs und Dienste aktivieren.
  4. Geben Sie in das 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 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 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-Protokolle und Fehlerberichte in der Google Cloud Console ansehen

Wenn Sie für Ihr Scriptprojekt Google Cloud-Protokolle oder Fehlerberichte verwenden, können Sie diese Protokolle und Berichte in der Google Cloud Console aufrufen. Gehen Sie dazu so vor:

  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. Wenn Sie sich Fehlerberichte ansehen möchten, scrollen Sie nach unten zum Bereich Vorgänge und klicken Sie auf Fehlerberichte. Wenn Sie aufgefordert werden, die Fehlerberichte einzurichten, wurden in Ihrem Scriptprojekt noch keine Ausnahmen protokolliert.

Wenn Sie Dienste verwenden, für die OAuth erforderlich ist, fordert Google die Nutzer auf, diese Dienste zu autorisieren. Mit den Einstellungen für den OAuth-Zustimmungsbildschirm können Sie einige der Informationen festlegen, die Google Nutzern präsentiert, z. B. den Namen der Anwendung und die URL der Nutzungsbedingungen.

Bei Standard-Cloud-Projekten wird automatisch ein Einwilligungsbildschirm aus den Projektdetails des Apps Script erstellt. Diese Einstellungen können nicht angepasst werden. Bei 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 alle Abschnitte des Workflows für den Einwilligungsbildschirm aus.
  5. Wenn Sie Ihre Änderungen in jeder Phase des Workflows speichern möchten, klicken Sie auf Speichern und fortfahren.

OAuth-Anmeldedaten erstellen

In der Regel wird OAuth in Apps Script für die Dienste eingerichtet, die in Ihrem Script verwendet werden. Für einige Anwendungen müssen Sie zusätzliche OAuth-Anmeldedaten (Client-IDs und Clientschlüssel) erstellen. Das ist nur bei Standardprojekten möglich.

So erstellst du eine Client-ID und einen Clientschlüssel für dein Script-Projekt:

  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 angezeigte 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 Standard-Cloud-Projekt 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 immer jemand in Ihrem Team Zugriff auf die Google Cloud-Einstellungen des Scriptprojekts hat.

So fügen Sie einem Standardprojekt zusätzliche Eigentümer oder andere Rollen hinzu: Sie benötigen Bearbeitungsberechtigungen für das Projekt, um folgende Änderungen vorzunehmen:

  1. Legen Sie fest, wer Ihre Mitbearbeiter sein sollen. 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 ein oder mehrere neue Mitglieder und ihre Rollen für das Cloud-Projekt hinzuzufügen. Sie können einzelne E-Mail-Adressen, Google-Gruppen oder Domains als neue Mitglieder hinzufügen.
  6. Klicken Sie auf Speichern.

Mehrere Scripts in einem einzigen Cloud-Projekt gruppieren

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

Ein anderes Standard-Cloud-Projekt verwenden

Sie können ein Skriptprojekt so ändern, dass ein anderes Cloud-Standardprojekt verwendet wird. Wenn für Ihr Script 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 Standard-Cloud-Projekte.

Auswirkungen des Wechsels zu einem anderen Standard-Cloud-Projekt

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

  • Wenn Sie erweiterte Dienste für Ihr Script 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 in Ihrem Script der integrierte Google Drive-Dienst verwendet wird, müssen Sie die Drive API in Standard-Cloud-Projekten aktivieren.

    Aktivieren Sie in Ihrem Standard-Cloud-Projekt 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 Script mit einem App-Eintrag im Google Workspace Marketplace verknüpft ist, werden der App-Eintrag, die Nutzer und die Rezensionen nicht in das neue Projekt übernommen. Sie müssen einen App-Eintrag im neuen Projekt 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. In Apps Script werden Standardprojekte gelöscht, nachdem Sie das Script so konfiguriert haben, dass es ein Standardprojekt verwendet.

Zu einem anderen Standard-Cloud-Projekt wechseln

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

  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 auf der Seite Google Cloud Console 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. Sie benötigen die Rollen „Sucher für das Projekt“ und „Bearbeiter der OAuth-Konfiguration“ oder Rollen mit entsprechenden Berechtigungen für das Projekt. Sie können kein Projekt verwenden, das automatisch mit Apps Script erstellt wurde.
  3. Bestimmen Sie die Projektnummer Ihres Cloud-Projekts.
  4. Öffnen Sie das Script, 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 (früher Teamablagen) sind gemeinsam nutzbare Bereiche, in denen Gruppen von Drive-Nutzern an Apps Script-Projekten und Drive-Dokumenten zusammenarbeiten können. Freigegebene Laufwerke sind nützlich, wenn Sie Scripts, Add-ons und Webanwendungen gemeinsam mit einem Team entwickeln. Sie beschränken jedoch die Möglichkeiten, die Sie mit älteren Standard-Cloud-Projekten haben.

In der folgenden Liste von Einschränkungen wird beschrieben, wie Cloud-Projekte mit freigegebenen Laufwerken interagieren:

  • Wenn für Ihr Scriptprojekt ein Standardprojekt verwendet wird, gibt es keine zusätzlichen Einschränkungen, wenn sich das Scriptprojekt in einer freigegebenen Ablage befindet.
  • Wenn für Ihr Scriptprojekt ein Standardprojekt verwendet wird, das am oder nach dem 8. April 2019 erstellt wurde, gibt es keine zusätzlichen Einschränkungen, wenn sich das Scriptprojekt auf einem freigegebenen Laufwerk befindet.
  • Wenn für Ihr Scriptprojekt ein Standardprojekt verwendet wird, das vor dem 8. April 2019 erstellt wurde, gelten die folgenden Einschränkungen, während sich das Scriptprojekt auf einem freigegebenen Laufwerk befindet:
    1. Sie können nicht über die Apps Script-Benutzeroberfläche oder die Google Cloud Console auf das Standardprojekt zugreifen. Aufgrund dieser Einschränkung können Sie keine Aktionen ausführen, für die ein direkter Zugriff auf das Projekt erforderlich ist.
    2. Sie können keine erweiterten Dienste aktivieren. Wenn Sie erweiterte Dienste aktivieren möchten, wechseln Sie zu einem Standardprojekt.
    3. Wenn Sie ein vorhandenes Apps Script-Projekt in eine freigegebene Google Drive-Ablage verschieben, schränkt Google den Zugriff auf das Standard-Cloud-Projekt ein. Wenn Sie vor dem Verschieben Zugriff auf das Standardprojekt hatten, können Sie weiterhin darauf zugreifen. Wenn Sie beispielsweise ein Script in Ihrem Ordner „Meine Ablage“ erstellt und dann in eine geteilte Ablage verschoben haben, können Sie weiterhin auf das Cloud-Projekt des Scripts zugreifen. Ihre Mitbearbeiter in der geteilten Ablage können das möglicherweise nicht.
    4. Ein Script behält den Namen des Cloud-Projekts, den es vor dem Verschieben in eine freigegebene Ablage hatte. Auch wenn Sie den Projektnamen in der freigegebenen Ablage ändern, sehen Nutzer, die das Script 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 dem Ordner ansehen.

  1. Öffnen Sie die Seite Google Cloud Console Ressourcen verwalten.
  2. Kopieren Sie die ID neben dem Ordner Apps Script.
  3. Klicken Sie auf Filter > Übergeordnete ID und fügen Sie die ID des Apps Script-Ordners 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).