Google Cloud-Projekte

Jedes Google 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 Apps Script automatisch erstellt, oder ein Standardprojekt, das Sie selbst erstellen. Im Allgemeinen eignen sich Standardprojekte für alltägliche 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 bestätigen müssen.

Standard-Cloud-Projekte

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

  • 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 Skripts müssen Sie mit der Google Cloud Console interagieren. In diesen Fällen muss in Ihrem Script 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, ansehen oder bearbeiten. Wenn Sie Administrator sind, lesen Sie den Abschnitt Standard-Google Cloud-Projekte ansehen.

Wenn Sie Ihr Scriptprojekt 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.

Standardprojekte können von Nutzern ohne Administratorrolle nicht manuell gelöscht werden. Wenn Sie das Skriptprojekt jedoch löschen oder zu einem Standardprojekt wechseln, löscht Apps Script das mit dem Skript verknüpfte Standardprojekt zusammen mit seinen Einstellungen und 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 Apps Script ein Standardprojekt erfordert, welche Eigenschaften es hat und welche Aufgaben häufig anfallen. Führen Sie diese Aufgaben nur mit Standardprojekten aus.

Wann sind Standard-Cloudprojekte für Apps Script erforderlich?

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

Standardmäßige Cloud-Projekteigenschaften

Standardprojekte haben die folgenden Eigenschaften:

  • Greifen Sie direkt über die Google Cloud Console auf alle Google Cloud-Einstellungen für das Projekt zu. So können Sie APIs aktivieren, Autorisierungsanmeldedaten anpassen und andere Details konfigurieren.
  • Wenn Sie ein Scriptprojekt 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 auf dem 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 Apps Script API-Methode scripts.run 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 Namen für das Cloud-Projekt fest.

Auf ein Standard-Cloud-Projekt zugreifen

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

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

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

API in einem Standard-Cloud-Projekt aktivieren

Wenn Sie einer Apps Script-Anwendung Zugriff auf eine andere Google-API gewähren möchten, aktivieren Sie die API im entsprechenden Cloud-Projekt:

  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.

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 konfigurieren, indem Sie sie im Dashboard APIs & Dienste auswählen.

ID und Nummer eines Standard-Cloud-Projekts ermitteln

Alle Cloud-Projekte haben einen Namen, eine ID und eine Nummer. Möglicherweise 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 aus Ziffern, während die Projekt-ID alphanumerisch ist. Bearbeiten Sie den Projektnamen, der Nutzern bei 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. Klicken Sie im Bereich Vorgänge auf Logging > Log-Explorer.
  4. Klicken Sie im Bereich Vorgänge auf Error Reporting, um Fehlerberichte aufzurufen. 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 wird festgelegt, welche Informationen Google den Nutzern präsentiert, z. B. der Anwendungsname 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. In Standard-Cloud-Projekten können Sie diese Informationen anpassen. So konfigurieren Sie den Zustimmungsbildschirm 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 auf Speichern und fortfahren, um Ihre Änderungen in jeder Phase zu speichern.

OAuth-Anmeldedaten erstellen

Normalerweise richtet Apps Script OAuth für die Dienste ein, die von Ihrem Skript verwendet werden. Für einige Anwendungen müssen Sie zusätzliche OAuth-Anmeldedaten (Client-IDs und Clientschlüssel) erstellen. Führen Sie diesen Schritt nur bei Standardprojekten aus.

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 Formular aus. Wenn Sie fertig sind, klicken Sie auf Erstellen.
  5. Klicken Sie im Dialogfeld auf JSON herunterladen. Mit dieser Datei können Sie OAuth konfigurieren.

Einem Standard-Cloud-Projekt weitere Inhaber hinzufügen

Fügen Sie einem Standardprojekt zusätzliche Inhaber oder andere Rollen hinzu, damit immer ein Mitglied Ihres Teams Zugriff auf die Google Cloud-Einstellungen des Skriptprojekts hat.

So fügen Sie einem Standardprojekt zusätzliche Inhaber oder andere Rollen hinzu (erfordert Bearbeitungsberechtigungen):

  1. Legen Sie Ihre Mitbearbeiter fest. Wir empfehlen die Verwendung einer Google-Gruppe. Geben Sie Domains an, 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 neue Mitglieder und ihre Rollen hinzuzufügen. Fügen Sie einzelne E‑Mail-Adressen, Google-Gruppen oder Domains hinzu.
  6. Klicken Sie auf Speichern.

Mehrere Skripts mit 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.

Wenn Sie Ihr Skriptprojekt als Add-on auf dem Marketplace veröffentlichen möchten, muss es ein eigenes Standardprojekt haben. Veröffentlichte Apps können keine Cloud-Projekte gemeinsam nutzen.

Ein anderes Standard-Cloud-Projekt verwenden

Ein Skriptprojekt kann auf ein anderes Standard-Cloud-Projekt umgestellt werden. Wenn für Ihr Skript eine manuelle Konfiguration des Cloud-Projekts erforderlich ist, wechseln Sie von einem Standardprojekt zu einem Standardprojekt. Weitere Informationen 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 umwandeln. 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 aussagekräftigen Projektnamen fest, damit Sie das Projekt auf der Seite Ressourcen verwalten der Google Cloud Console 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-Projekt auf Projekt wechseln.
  7. Geben Sie die neue Projektnummer ein und klicken Sie auf Projekt festlegen.

Cloud-Projekte und geteilte Ablagen

Freigegebene Ablagen sind nur für Kunden mit Google Workspace Business und Google Workspace Enterprise verfügbar.

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 Ablagen sind nützlich, wenn Sie mit einem Team Skripts, Add-ons und Web-Apps entwickeln. Sie unterliegen jedoch einigen Einschränkungen, was Sie mit älteren Standard-Cloud-Projekten tun können.

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

  • Wenn in Ihrem Skriptprojekt ein Standardprojekt verwendet wird, gelten keine zusätzlichen Einschränkungen, wenn sich das Skriptprojekt 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 Cloud-Projektnamen bei, den 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, in den Autorisierungsdialogfeldern weiterhin den alten Namen.

Wenn Sie diese 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 Ordner-ID des Apps Script-Projekts ein.

Apps Script-Cloud-Projekte löschen

Sie müssen Administrator sein, um Standardprojekte löschen zu können.

So löschen Sie ein Apps Script-Projekt aus der Google Cloud Console:

  1. Cloud-Projekt öffnen
  2. Klicken Sie rechts oben auf das Dreipunkt-Menü  > Projekteinstellungen.
  3. Klicken Sie auf Herunterfahren / Löschen.
  4. Folgen Sie der Anleitung auf dem Bildschirm, um das Projekt zu beenden.

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).