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. Für Ihr Script-Projekt können Sie ein Standardprojekt verwenden, das in Apps Script automatisch erstellt wird, oder ein Standardprojekt, das Sie selbst erstellen. 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, aber nicht zurück zu einem Standardprojekt. Es empfiehlt sich, 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 Scripts müssen Sie dieses Standardprojekt nie aufrufen 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-Protokolle in der Google Cloud Console aufrufen möchten, muss Ihr Script 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.

Standard-Cloud-Projekte ansehen oder aktualisieren

Die meisten Nutzer können Standardprojekte in der Google Cloud Console nicht direkt aufrufen, ansehen oder bearbeiten. Wenn Sie Administrator sind, lesen Sie den Hilfeartikel Standard-Google Cloud-Projekte 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. Wenn Sie auf das Standardprojekt zugreifen möchten, rufen Sie die Einstellungen des Scriptprojekts auf und klicken Sie auf die Projektnummer.

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.

Wenn Sie kein Administrator sind, können Sie keine Standardprojekte löschen. 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 neues 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 Fällen müssen Sie ein Standardprojekt verwenden:

Standardeigenschaften von Cloud-Projekten

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

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.

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 und Dienste auswählen.

ID und Nummer eines Standard-Cloud-Projekts 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 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 Nutzer Dienste verwenden, für die OAuth erforderlich ist, werden sie von Google aufgefordert, 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 Einwilligungsbildschirm Ihres Scripts:

  1. Öffnen Sie das Cloud-Projekt.
  2. Klicken Sie auf das Dreistrich-Menü  > APIs & 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 & 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 zusätzliche Inhaber oder andere Rollen hinzufügen. Wenn Sie an einem Projekt zusammenarbeiten, ist so sichergestellt, 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 Scripts.
  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 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 dann bei jedem Scriptprojekt zu diesem Projekt. Bei Standardprojekten ist das nicht möglich.

Ein anderes Standard-Cloud-Projekt verwenden

Sie können ein Scriptprojekt so ändern, dass es ein anderes Standard-Cloud-Projekt verwendet. 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 Script von einem Standardprojekt zu einem anderen Standardprojekt wechseln, hat das folgende Auswirkungen:

  • Wenn Sie erweiterte Dienste für Ihr Script aktiviert haben, müssen Sie die entsprechenden APIs im neuen Cloud-Projekt aktivieren. Alle Daten, die mit den erweiterten Diensten im vorherigen Cloud-Projekt verknüpft sind, gehen verloren. 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 Script zuvor autorisiert haben, müssen es noch einmal autorisieren. In den meisten Fällen müssen auch alle Nutzer, die zuvor Apps autorisiert haben, die mit dem neuen Projekt verknüpft sind, diese Autorisierung noch einmal vornehmen.
  • 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 Script nicht zurück zu einem Standardprojekt wechseln. 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, erstellen Sie eines. 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. Dieser Name wird in Apps Script verwendet, wenn Nutzer aufgefordert werden, das Script zu autorisieren.
  2. Wenn Sie ein vorhandenes Projekt verwenden möchten, öffnen Sie die Seite Google Cloud Console Ressourcen verwalten und suchen Sie nach einem vorhandenen 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. Ermitteln 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 gemeinsam an Apps Script-Projekten und Drive-Dokumenten arbeiten 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, solange 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.

Wenn Sie die oben genannten Einschränkungen für ältere Scripts vermeiden möchten, 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 im Ordner aufrufen.

  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, folgen Sie der Anleitung unter Liste von Apps Script-Cloud-Projekten abrufen, 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).