Google Cloud-Projekte

Jedes Apps Script-Projekt verwendet Google Cloud, um Autorisierungen, erweiterte Dienste und andere Details zu verwalten. Zum Konfigurieren und Verwalten dieser Einstellungen ist jedem Apps Script-Projekt ein Google Cloud-Projekt zugeordnet. Ihr Script-Projekt kann ein Standardprojekt verwenden, das von Apps Script automatisch erstellt wird, oder ein Standardprojekt, das Sie selbst erstellen. Im Allgemeinen eignen sich Standardprojekte für alltägliche oder einfache Skripts. Für komplexe Anwendungen, Anwendungen in kommerzieller Qualität oder Anwendungen, die Sie veröffentlichen möchten, sollten Sie jedoch ein Standardprojekt verwenden.

Sie können jederzeit von einem Standardprojekt zu einem Standardprojekt wechseln, aber nicht wieder zurück zu einem Standardprojekt. Es ist am besten, das Cloud-Projekt, das Ihr Skript verwendet, früh in der Entwicklung auszuwählen. Ein späterer Wechsel kann zu Komplikationen führen, z. B. dazu, dass Ihre Nutzer die Autorisierung noch einmal durchführen müssen.

Cloud-Standardprojekte

Wenn Sie ein Apps Script-Projekt erstellen, wird im Hintergrund ein Standard-Cloud-Projekt erstellt.

  • Bei den meisten Skripts müssen Sie dieses Standardprojekt nie aufrufen oder anpassen. Das Apps Script übernimmt die erforderlichen Interaktionen mit Google Cloud. Wenn Sie beispielsweise einen erweiterten Dienst im Apps Script-Editor aktivieren, wird der erweiterte Dienst in Apps Script im Standard-Cloud-Projekt aktiviert, wenn Sie das Skriptprojekt speichern.
  • Bei einigen Skripts müssen Sie mit der Google Cloud Console interagieren. In diesen Fällen muss in Ihrem Skript stattdessen ein Standard-Cloud-Projekt verwendet werden. Wenn Sie beispielsweise Google Cloud-Logs in der Google Cloud Console aufrufen möchten, muss in Ihrem Skript ein Standardprojekt verwendet werden.

Standardmäßig haben Cloud-Projekte eine IAM-Richtlinie (Identity and Access Management) mit einem Eintrag: ein Google-Dienstkonto, das als Inhaber des Standardprojekts fungiert. Das Google-Dienstkonto ist 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 finden, aufrufen oder bearbeiten. Wenn Sie Administrator sind, lesen Sie den Abschnitt Standard-Google Cloud-Projekte 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. Wenn Sie auf das Standardprojekt zugreifen möchten, rufen Sie die Einstellungen des Skriptprojekts auf und klicken Sie auf die Projektnummer.

Standard-Cloud-Projekte löschen

Als Administrator können Sie Standard-Cloud-Projekte wie normale Cloud-Projekte löschen. Weitere Informationen finden Sie unter Standard-Cloud-Projekte ansehen oder bearbeiten.

Wenn Sie kein Administrator sind, können Sie Standardprojekte nicht manuell löschen. Wenn Sie das Skriptprojekt jedoch löschen oder es auf ein Standardprojekt umstellen, löscht Apps Script das mit dem Skript verknüpfte Standardprojekt zusammen mit allen darin enthaltenen Einstellungen oder Informationen.

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 Skriptprojekt auf ein Standardprojekt umstellen.

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

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

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

Standardmäßige Cloud-Projekteigenschaften

Standardprojekte haben die folgenden 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, Autorisierungsanmeldedaten anpassen und andere Details konfigurieren.
  • Wenn Sie ein Skriptprojekt löschen oder es so ändern, dass ein anderes Standardprojekt verwendet wird, 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 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. Veröffentlichte Apps können Cloud-Projekte nicht mit anderen Apps teilen.
  • Wenn Sie Funktionen in einem Skriptprojekt über eine andere App mit der Methode scripts.run der Apps Script API ausführen möchten, müssen das Skriptprojekt und die aufrufende Anwendung dasselbe Standardprojekt verwenden.
  • 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 Name des Skriptprojekts). Legen Sie daher einen geeigneten Cloud-Projektnamen fest.

Auf ein Standard-Cloud-Projekt zugreifen

So greifen Sie auf das Standardprojekt zu, das mit Ihrem Script-Projekt verknüpft ist:

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

Sie können ein Standardprojekt auch direkt auf der Seite Ressourcen verwalten in der Google Cloud Console finden.

API in einem Standard-Cloud-Projekt 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. Cloud-Projekt öffnen
  2. Klicken Sie auf das 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 & 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. Cloud-Projekt öffnen
  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 in Autorisierungsaufforderungen angezeigt wird.

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

Wenn Sie Google Cloud Logging oder Error Reporting für Ihr Skriptprojekt verwenden, können Sie die entsprechenden Logs und Berichte in der Google Cloud Console aufrufen. Gehen Sie dazu so vor:

  1. Cloud-Projekt öffnen
  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 zum Aufrufen von Fehlerberichten nach unten zum Bereich Vorgänge und klicken Sie auf Error Reporting. Wenn Sie aufgefordert werden, die Fehlerberichterstattung einzurichten, bedeutet das, dass in Ihrem Skriptprojekt noch keine Ausnahmen protokolliert wurden.

Wenn Nutzer Dienste verwenden, für die OAuth erforderlich ist, werden sie von Google aufgefordert, diese Dienste zu autorisieren. In den Einstellungen für den OAuth-Zustimmungsbildschirm können Sie einige der Informationen festlegen, die Google Nutzern präsentiert, z. B. den Anwendungsnamen und die URL der Nutzungsbedingungen.

Bei Standard-Cloud-Projekten wird automatisch ein Zustimmungsbildschirm aus den Apps Script-Projektdetails erstellt. Diese Einstellungen können Sie nicht anpassen. Bei Standard-Cloud-Projekten können Sie diese Informationen anpassen. So konfigurieren Sie den Einwilligungsbildschirm Ihres Skripts:

  1. Cloud-Projekt öffnen
  2. Klicken Sie auf das Menü  > APIs & Dienste > Anmeldedaten.
  3. Klicken Sie auf Zustimmungsbildschirm konfigurieren.
  4. Füllen Sie die einzelnen Abschnitte des Zustimmungsbildschirm-Workflows aus.
  5. Klicken Sie in jeder Phase des Workflows auf Speichern und fortfahren, um die Änderungen zu speichern.

OAuth-Anmeldedaten erstellen

In Apps Script wird OAuth in der Regel für die Dienste eingerichtet, die von 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 erstellen Sie eine Client-ID und einen Clientschlüssel für Ihr Skriptprojekt:

  1. Cloud-Projekt öffnen
  2. Klicken Sie auf das 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 das angezeigte Formular bei Bedarf 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 Standard-Cloud-Projekt weitere 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 Eigentümer oder andere Rollen hinzufügen. Gehen Sie dazu so vor: Sie benötigen eine Bearbeitungsberechtigung für das Projekt, um eine der folgenden Änderungen vorzunehmen:

  1. Legen Sie fest, wer Ihre Mitbearbeiter sein sollen. Wir empfehlen Ihnen, 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. Cloud-Projekt des Skripts öffnen
  3. Klicken Sie auf das 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 in einem einzigen Cloud-Projekt gruppieren

Mehrere Apps Script-Projekte können dasselbe Standard-Cloud-Projekt verwenden. Erstellen Sie dazu ein Standardprojekt und stellen Sie dann jedes Skriptprojekt darauf um. Bei Standardprojekten ist das nicht möglich.

Ein anderes Standard-Cloud-Projekt verwenden

Sie können ein Scriptprojekt so umstellen, dass es ein anderes Standard-Cloud-Projekt 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 Standard-Cloud-Projekte.

Auswirkungen des Wechsels zu einem anderen Standard-Cloud-Projekt

Wenn Sie Ihr Skript von einem Standardprojekt oder zu einem anderen Standardprojekt wechseln, 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. 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 Skript der integrierte Google Drive-Dienst verwendet wird, müssen Sie die Drive API in Standard-Cloud-Projekten aktivieren.

    Aktivieren Sie die Drive API in Ihrem Standard-Cloud-Projekt:

    Drive API aktivieren

  • Alle Nutzer, die das Script zuvor autorisiert haben, müssen es noch einmal autorisieren. In den meisten Fällen müssen sich alle Nutzer, die zuvor Apps autorisiert haben, die mit dem neuen Projekt verknüpft sind, noch einmal autorisieren.
  • Wenn Ihr Skript 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 übertragen. 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 wieder in ein Standardprojekt verschieben. Apps Script löscht Standardprojekte, nachdem Sie das Skript so eingerichtet haben, dass ein Standardprojekt verwendet wird.

Zu einem anderen Standard-Cloud-Projekt wechseln

So wechseln Sie mit einem vorhandenen Cloud-Projekt eines Skripts zu einem anderen Cloud-Projekt:

  1. Wenn Sie kein geeignetes Cloud-Projekt haben, erstellen Sie eines, indem Sie der Anleitung unter Projekt erstellen folgen. Legen Sie einen einprägsamen Projektnamen fest, damit Sie das Projekt 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 die Seite Google Cloud Console Ressourcen verwalten und suchen Sie nach einem vorhandenen Projekt, das Sie verwenden möchten. Sie benötigen die Rollen „Project Browser“ und „OAuth Config Editor“ oder Rollen mit den entsprechenden Berechtigungen für das Projekt. Sie können kein Projekt verwenden, das automatisch von Apps Script erstellt wurde.
  3. Projektnummer Ihres Cloud-Projekts ermitteln
  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 Ablagen sind nützlich, wenn Sie mit einem Team Skripts, Add-ons und Web-Apps entwickeln. Sie schränken jedoch ein, was Sie mit älteren Standard-Cloud-Projekten tun können.

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

  • Wenn in Ihrem Scriptprojekt ein Standardprojekt verwendet wird, gelten keine zusätzlichen Einschränkungen, wenn sich das Scriptprojekt in einer geteilten Ablage befindet.
  • Wenn in Ihrem Scriptprojekt ein Standardprojekt verwendet wird, das am oder nach dem 8. April 2019 erstellt wurde, gelten keine zusätzlichen Einschränkungen, wenn sich das Scriptprojekt auf einem freigegebenen Laufwerk befindet.
  • Wenn in Ihrem Skriptprojekt ein Standardprojekt verwendet wird, das vor dem 8. April 2019 erstellt wurde, gelten die folgenden Einschränkungen, solange sich das Skriptprojekt in einer geteilten Ablage befindet:
    1. Sie können nicht über die Apps Script-Benutzeroberfläche oder die Google Cloud Console auf das Standardprojekt zugreifen. Diese Einschränkung verhindert, dass Sie Aktionen ausführen, für die direkter Zugriff auf das Projekt erforderlich ist.
    2. Sie können erweiterte Dienste nicht aktivieren. Wenn Sie erweiterte Dienste aktivieren möchten, müssen Sie zu einem Standardprojekt wechseln.
    3. Wenn Sie ein vorhandenes Apps Script-Projekt in eine geteilte Ablage verschieben, schränkt Google den Zugriff auf das Standard-Cloud-Projekt ein. Sie können weiterhin auf das Standardprojekt zugreifen, wenn Sie vor der Migration Zugriff darauf hatten. Wenn Sie beispielsweise ein Skript in Ihrem Ordner „Meine Ablage“ erstellt und es 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, den es vor dem Verschieben auf ein gemeinsames Laufwerk hatte. Auch wenn Sie den Projektnamen in der geteilten Ablage ändern, sehen Nutzer, die das Skript autorisieren, in den Autorisierungsdialogfeldern weiterhin den alten Namen.

Wenn Sie die oben genannten Einschränkungen für ältere Skripts vermeiden möchten, wechseln Sie zu einem Standardprojekt.

Liste der Apps Script-Cloudprojekte 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 ansehen.

  1. Öffnen Sie die Google Cloud Console und rufen Sie die Seite Ressourcen verwalten auf.
  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, 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).