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. Im Allgemeinen eignen sich Projekte gut für tägliche oder einfache Skripts. Sie sollten jedoch ein Standardprojekt für jede Anwendung verwenden, die komplex ist, eine kommerzielle Qualität hat oder für die Veröffentlichung bestimmt ist.

Sie können jederzeit von einem Standardprojekt zu einem Standardprojekt wechseln. Ein Standardprojekt kann jedoch nicht mehr zurückwechseln. Am besten wählen Sie das Google Cloud-Projekt aus, das Ihr Skript frühzeitig in der Entwicklung verwendet. Wenn Sie später wechseln, können Komplikationen entstehen, z. B. dass die Nutzer sich noch einmal autorisieren müssen.

Google Cloud-Standardprojekte

Wenn Sie ein Apps Script-Projekt erstellen, erstellt Apps Script ein Google Cloud-Standardprojekt, das im Hintergrund ausgeführt wird.

  • Bei den meisten Skripts müssen Sie dieses Standardprojekt nicht aufrufen oder anpassen. Apps Script übernimmt die erforderlichen Interaktionen mit Google Cloud. Wenn Sie beispielsweise einen erweiterten Dienst im Apps Script-Editor aktivieren, aktiviert Apps Script den erweiterten Dienst im Google 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 Google Cloud-Standardprojekt verwenden. Wenn Sie beispielsweise Google Cloud-Logs in der Google Cloud Console ansehen möchten, muss Ihr Skript ein Standardprojekt verwenden.

Google Cloud-Standardprojekte ansehen oder aktualisieren

Die meisten Nutzer können Standardprojekte nicht direkt in der Google Cloud Console suchen, ansehen oder bearbeiten. Administratoren und Domainnutzer mit der Berechtigung resourcemanager.projects.list für den übergeordneten Google Cloud-Ordner können Standardprojekte ansehen und konfigurieren.

  • Für Google Workspace-Kunden fallen die Standardprojekte in der Cloud-Ressourcenhierarchie in den Ordner Organization root > system-gsuite > apps-script. Diese Ordner nicht löschen. Ist das der Fall, können Skripts keine Standardprojekte erstellen und nicht korrekt ausgeführt werden.
  • Für Kunden, die Google Workspace nicht verwenden, wurden die Standardprojekte in der Ressourcenhierarchie übergeordnet.

Google Cloud-Standardprojekte löschen

Als Administrator können Sie Google Cloud-Standardprojekte genau wie Google Cloud-Standardprojekte löschen. Siehe Apps Script-Google Cloud-Projekte löschen.

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

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

Google Cloud-Standardprojekte

Google Cloud-Standardprojekte sind für die meisten Skriptprojekte die beste Option, es sei denn, Sie müssen das Projekt manuell konfigurieren. In diesen Fällen müssen Sie das Skriptprojekt auf ein Standardprojekt umstellen.

In den folgenden Abschnitten wird beschrieben, wann Apps Script ein Standardprojekt erfordert. Außerdem wird beschrieben, welche Eigenschaften solche Projekte haben und welche häufigen Aufgaben damit ausgeführt werden. Sie können die folgenden Aufgaben nur mit Standardprojekten ausführen.

Wenn für Apps Script Google Cloud-Standardprojekte erforderlich sind

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

Google Cloud-Standard-Projektattribute

Standardprojekte haben die folgenden Properties:

  • Sie können alle Google Cloud-Einstellungen für das Projekt direkt über die Google Cloud Console aufrufen. Dadurch können Sie APIs aktivieren, Anmeldedaten für die Autorisierung anpassen und weitere Details konfigurieren.
  • Wenn Sie ein Skriptprojekt löschen oder zu einem anderen Standardprojekt wechseln, 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 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 Google Cloud-Projekte nicht mit anderen Anwendungen teilen.
  • Wenn Sie Funktionen in einem Skriptprojekt aus einer anderen Anwendung mit der scripts.run-Methode 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 Google Cloud-Projektname zur Identifizierung des Skripts und nicht der Skriptprojektname verwendet. Legen Sie daher einen geeigneten Google Cloud-Projektnamen fest.

Auf ein Google Cloud-Standardprojekt zugreifen

So greifen Sie auf das Standardprojekt zu, das Ihrem Skriptprojekt zugeordnet ist:

Neuer Editor

  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.

Alter Editor

  1. Öffnen Sie das Skript im Apps Script-Editor.
  2. Wählen Sie Ressourcen &Cloud Platform-Projekt aus.
  3. Klicken Sie im angezeigten Dialogfeld auf den obersten Link, der auf den Namen des GCP-Projekts verweist.

Sie finden ein Standardprojekt auch direkt auf der Seite Ressourcen verwalten der Google Cloud Console.

API in einem Google 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 Google Cloud-Projekt aktivieren. So aktivieren Sie eine API:

  1. Öffnen Sie das Google Cloud-Projekt.
  2. Klicken Sie auf das Dreistrich-Menü > APIs &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 Google 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 möglicherweise die API auch konfigurieren, indem Sie sie im Dashboard APIs &Dienste auswählen.

ID eines Google Cloud-Standardprojekts ermitteln

Alle Google Cloud-Projekte haben einen Projektnamen, eine Projekt-ID und eine Projektnummer. Gelegentlich benötigen Sie diese Kennzeichnungen, um Dienste zu konfigurieren oder andere Aufgaben auszuführen.

So ermitteln Sie die ID und die Nummer Ihres Standardprojekts:

  1. Öffnen Sie das Google 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, 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 Skriptprojekt Cloud Logging oder Fehlerberichte verwenden, können Sie diese Logs und Berichte in der Google Cloud Console so aufrufen:

  1. Öffnen Sie das Google Cloud-Projekt.
  2. Klicken Sie auf das Dreistrich-Menü .
  3. Scrollen Sie nach unten zum Abschnitt Vorgänge und klicken Sie auf Logging > Log-Explorer.
  4. Scrollen Sie zum Abschnitt Vorgänge nach unten und klicken Sie auf Fehlerberichte, um Fehlerberichte anzusehen. Wenn Sie aufgefordert werden, Fehlerberichte einzurichten, bedeutet dies, dass Ihr Skriptprojekt noch keine Ausnahmen protokolliert hat.

Wenn Sie Dienste verwenden, für die OAuth erforderlich ist, werden Nutzer von Google aufgefordert, diese Dienste zu autorisieren. Über die Einstellungen des OAuth-Zustimmungsbildschirms können Sie einige der Informationen festlegen, die Google den Nutzern anzeigt, z. B. den Anwendungsnamen und die URL der Nutzungsbedingungen.

Google Cloud-Standardprojekte erstellen automatisch einen Zustimmungsbildschirm aus den Apps Script-Projektdetails. Diese Einstellungen können Sie nicht anpassen. Mit Google Cloud-Standardprojekten können Sie diese Informationen anpassen. So konfigurieren Sie den Einwilligungsbildschirm Ihres Skripts:

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

OAuth-Anmeldedaten erstellen

Apps Script richtet OAuth normalerweise für die Dienste ein, die Ihr Skript verwendet. Für einige Anwendungen müssen Sie zusätzliche OAuth-Anmeldedaten erstellen (Client-IDs und Clientschlüssel). 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 Google 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 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.

Weiteren Google Cloud-Standardprojekten weitere Inhaber hinzufügen

Sie können einem Standardprojekt zusätzliche Inhaber oder andere Rollen hinzufügen. Wenn Sie gemeinsam an einem Projekt arbeiten, können Sie dafür sorgen, dass immer jemand aus 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 diese Änderungen vorzunehmen:

  1. Legen Sie fest, wer Ihre Mitbearbeiter sein sollen. Wir empfehlen, dass Sie eine vorhandene Google-Gruppe erstellen oder verwenden. Sie können in der Liste der Mitbearbeiter auch Domains angeben, um alle Nutzer in dieser Domain einzuschließen.
  2. Öffnen Sie das Google 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 Google Cloud-Projekt ein oder mehrere neue Mitglieder und ihre Rollen hinzuzufügen. Sie können einzelne E-Mails, Google Groups-Gruppen oder Domains als neue Mitglieder hinzufügen.
  6. Klicken Sie auf Speichern.

Mehrere Skripts mit einem einzigen Google Cloud-Projekt gruppieren

Sie können mehrere Apps Script-Projekte mit demselben Google Cloud-Standardprojekt verwenden. Erstellen Sie dazu ein Standardprojekt und wechseln Sie dann jedes Skriptprojekt zur Verwendung. Dies ist bei Standardprojekten nicht möglich.

Zu einem anderen Google Cloud-Standardprojekt wechseln

Sie können ein Skriptprojekt so ändern, dass ein anderes Google Cloud-Standardprojekt verwendet wird. Wenn Ihr Skript eine manuelle Konfiguration des Google Cloud-Projekts erfordert, müssen Sie zu einem Standardprojekt wechseln. Weitere Informationen zur Verwendung eines Standardprojekts finden Sie unter Google Cloud-Standardprojekte.

So wechseln Sie das bestehende Google Cloud-Projekt eines Skripts zu einem anderen Google Cloud-Projekt:

Neuer Editor

  1. Wenn Sie kein geeignetes Google 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 Ressourcen verwalten der Google Cloud Console finden können. Apps Script verwendet diesen Namen, wenn Nutzer aufgefordert werden, das Skript zu autorisieren.
  2. Wenn Sie ein vorhandenes Projekt verwenden möchten, öffnen Sie die Seite Ressourcen verwalten der Google Cloud Console und suchen Sie ein vorhandenes Projekt. Sie benötigen resourcemanager.projects.update-Berechtigungen für das Projekt. Sie können kein Projekt verwenden, das automatisch von Apps Script erstellt wurde.
  3. Bestimmen Sie die Projektnummer des Google Cloud-Projekts.
  4. Öffnen Sie das Skript, dessen Google 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.

Alter Editor

  1. Wenn Sie kein geeignetes GCP-Projekt haben, erstellen Sie ein neues Projekt. Folgen Sie dazu der Anleitung unter Projekt erstellen. Öffnen Sie andernfalls die Google Cloud Console-Seite Ressourcen verwalten und suchen Sie ein vorhandenes GCP-Projekt. Sie benötigen Bearbeitungsberechtigungen für das GCP-Projekt und die zugehörigen Einstellungen in der Google Cloud Console aufrufen können. Das neue Projekt kann nicht automatisch von Apps Script erstellt werden.
  2. Legen Sie einen einprägsamen GCP-Projektnamen fest, damit Sie ihn in der Google Cloud Console auf der Seite Ressourcen verwalten einfacher finden können. Er wird auch verwendet, um das Skript zu kennzeichnen, wenn Nutzer von Apps Script dazu aufgefordert werden.
  3. Bestimmen Sie die Projektnummer Ihres GCP-Projekts.
  4. Öffnen Sie im Apps Script-Editor das Skript, dessen GCP-Projekt Sie ersetzen möchten.
  5. Klicken Sie auf Ressourcen &Cloud Platform-Projekt.
  6. Fügen Sie im Abschnitt Projekt ändern die kopierte Projektnummer in das Textfeld ein und klicken Sie auf Projekt festlegen.
  7. Auf einem Warnbildschirm werden die Auswirkungen einer Änderung des Cloud Platform-Projekts erläutert. Lesen Sie die Hinweise sorgfältig durch und klicken Sie auf Bestätigen.

Google Cloud-Projekte und geteilte Ablagen

Geteilte Ablagen (ehemals Teamablagen) sind gemeinsam genutzte Bereiche, in denen Google Drive-Nutzer in Apps Script-Projekten und Drive-Dokumenten zusammenarbeiten können. Geteilte Ablagen sind nützlich, wenn Sie mit einem Team Skripts, Add-ons und Webanwendungen entwickeln. Es gibt jedoch einige Einschränkungen hinsichtlich der Möglichkeiten, die mit älteren Google Cloud-Standardprojekten möglich sind.

In der folgenden Liste von Einschränkungen wird beschrieben, wie Google 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. Über die Apps Script-UI oder die Google Cloud Console können Sie nicht auf das Standardprojekt zugreifen. Diese Einschränkung verhindert, dass Sie Aktionen ausführen können, die direkten Zugriff auf das Projekt erfordern.
    2. Sie können erweiterte Dienste nicht 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 Google 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 es dann in eine geteilte Ablage verschoben haben, können Sie weiterhin auf das Google Cloud-Projekt des Skripts zugreifen. Die Mitbearbeiter der geteilten Ablage können das möglicherweise nicht.
    4. Ein Skript behält den Namen des Google Cloud-Projekts, das es vor dem Verschieben in eine geteilte Ablage hatte. Auch wenn Sie den Projektnamen in der geteilten Ablage ändern, sehen Nutzer, die das Skript autorisieren, den alten Namen in Autorisierungsdialogen.

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

Liste der Apps Script-Google Cloud-Projekte abrufen

Wenn Sie die Berechtigung resourcemanager.projects.list für den Ordner „Apps Script Project“ Ihrer Organisation haben, können Sie alle standardmäßigen und standardmäßigen Google Cloud-Projekte von Apps Script innerhalb des Ordners 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-Google Cloud-Projekte löschen

Folgen Sie der Anleitung unter Liste von Apps Script-Google Cloud-Projekten abrufen, um ein Apps Script-Google Cloud-Projekt zu löschen. 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 Google Cloud-Projekten finden Sie unter Projekte beenden (löschen).