Google Cloud-Projekte

Bei jedem Apps Script-Projekt wird Google Cloud zum Verwalten der Autorisierung, Erweiterte Dienste und andere Details. Zum Konfigurieren und Verwalten dieser Einstellungen hat jedes Apps Script-Projekt ein verknüpftes Google Cloud-Projekt. Ihr Skriptprojekt kann Folgendes verwenden: Standardprojekt, das Apps Script enthält automatisch erstellt wird, Standardprojekt, das Sie erstellen selbst. Im Allgemeinen eignen sich Standardprojekte für alltägliche oder einfache Projekte. Skripts erstellt. Für jede Anwendung, die die eine komplexe, kommerzielle Qualität aufweisen oder von Ihnen veröffentlicht werden sollen.

Sie können von einem Standardprojekt zu einem Standardprojekt wechseln. Sie können jedoch nicht mehr zur Verwendung eines Standardprojekts zurückwechseln. Am besten um das Cloud-Projekt auszuwählen, das Ihr Skript bereits in der Entwicklung verwendet. Ein späterer Wechsel kann zu Komplikationen führen, z. B. dass Ihre Nutzer erneut autorisieren.

Cloud-Standardprojekte

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 beispielsweise Sie aktivieren im Apps Script-Editor einen erweiterten Dienst, Apps Script. aktiviert den erweiterten Dienst im Cloud-Standardprojekt, wenn Sie Speichern Sie das Skriptprojekt.
  • Bei einigen Scripts müssen Sie mit der Google Cloud Console interagieren. In diesen muss Ihr Skript stattdessen ein Cloud-Standardprojekt verwenden. Für Beispiel: Wenn Sie Google Cloud-Logs in der Google Cloud Console ansehen möchten, muss Ihr Skript ein Standardprojekt.

Cloud-Projekte haben standardmäßig eine Identitäts- und Zugriffsverwaltung IAM-Richtlinie mit einem Eintrag, einem Google-Dienstkonto, das als Inhaber das Standardprojekt. Das Google-Dienstkonto ist appsdev-apps-dev-script-auth@system.gserviceaccount.com

Standard-Cloud-Projekte ansehen oder aktualisieren

Die meisten Nutzer können Standardprojekte im Google Cloud Console Wenn Sie Administrator sind, lesen Sie den Hilfeartikel Standard-Google Cloud-Projekte ansehen.

Wenn Sie Ihr Skriptprojekt vor dem 8. April 2019 erstellt haben, können Sie ein Standardprojekt, auf das Sie in der Google Cloud Console zugreifen können. So greifen Sie auf die gehen Sie zu den Einstellungen des Skriptprojekts und klicken Sie auf das Projekt Nummer.

Cloud-Standardprojekte löschen

Als Administrator können Sie Cloud-Standardprojekte wie gewohnt löschen Cloud-Standardprojekte. Weitere Informationen finden Sie unter Cloud-Projekte in Apps Script löschen.

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

  • Wenn Sie das Skriptprojekt löschen oder auf ein Standardprojekt umstellen, Das Skript löscht das an das Skript angehängte Standardprojekt sowie alle Einstellungen oder Informationen enthält.
  • 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.

Cloud-Standardprojekte

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 Stellen Sie Ihr Skriptprojekt auf ein Standardprojekt um.

In den folgenden Abschnitten wird beschrieben, wann Apps Script die Eigenschaften solcher Projekte und die damit verbundenen häufigsten Aufgaben. Sie können nur die folgenden Aufgaben mit Standardprojekten ausführen.

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 die folgenden Attribute:

  • Sie können direkt auf alle Google Cloud-Einstellungen für das Projekt zugreifen über die Google Cloud Console. So können Sie APIs aktivieren und die Autorisierung anpassen Anmeldedaten konfigurieren und weitere 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 aktivieren in einem Skriptprojekt verwenden, müssen Sie die entsprechende API manuell im Standardprojekt.
  • Mehrere Scriptprojekte und andere Apps können dasselbe Standardprojekt verwenden. Wenn Sie ein Skriptprojekt veröffentlichen möchten zu den Google Workspace Marketplace als Add-on verwenden, muss ein eigenes Standardprojekt vorhanden sein. Bei veröffentlichten Apps können keine Cloud-Projekte für andere Apps freigegeben werden.
  • Wenn Sie Funktionen in einem Skriptprojekt über eine andere App mit mit der scripts.run-Methode der Apps Script API Das Skriptprojekt und die aufrufende Anwendung müssen denselben Standard Projekt arbeiten.
  • 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. Legen Sie daher einen geeigneten Name des Cloud-Projekts.

Auf ein Standard-Cloud-Projekt zugreifen

So greifen Sie auf das mit Ihrem Skript verknüpfte Standardprojekt zu: Projekt arbeiten, gehen Sie so vor:

  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.

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

API in einem Standard-Cloud-Projekt aktivieren

Oft benötigt eine Apps Script-Anwendung Zugriff auf eine andere Google API. Gehen Sie dazu wie folgt vor: müssen Sie die API im entsprechenden Cloud-Projekt aktivieren. So aktivieren Sie eine API:

  1. Öffnen Sie das Cloud-Projekt.
  2. Klicke auf das Dreistrich-Menü . > APIs und 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 zum Aktivieren auf Aktivieren. die API für dieses Cloud-Projekt.

Möglicherweise werden Sie aufgefordert, die Nutzungsbedingungen für Google APIs oder Google Cloud: Lesen Sie die Nutzungsbedingungen sorgfältig durch, bevor Sie sie akzeptieren.

Je nach Anwendung müssen Sie die API möglicherweise auch so konfigurieren, unter APIs und Dienste.

ID- und Cloud-Standardprojekt

Alle Cloud-Projekte haben einen Projektnamen, eine Projekt-ID und eine Projektnummer. Gelegentlich müssen Sie über diese Kennzeichnungen verfügen, um um Dienste zu konfigurieren oder andere Aufgaben zu erledigen.

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. Den Projektnamen, die Projekt-ID und die Projektnummer abrufen im Bereich Einstellungen. Die Projektnummer besteht nur aus Ziffern, während die Projekt-ID alphanumerisch ist. Sie können die Projektname, der Nutzern bei Autorisierungsaufforderungen angezeigt wird.

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

Wenn Sie Google Cloud Logging verwenden oder Fehlerberichte für Ihr Skriptprojekt haben, können Sie diese Protokolle und Berichte im Google Cloud Console. Gehen Sie dazu so vor:

  1. Öffnen Sie das Cloud-Projekt.
  2. Klicken Sie auf das Dreistrich-Menü .
  3. Scrollen Sie nach unten zum Abschnitt Vorgänge. 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, Fehlerberichte eingerichtet haben, bedeutet dies, dass Ihr Skriptprojekt noch Ausnahmen protokolliert.

Wenn Sie Dienste verwenden, für die OAuth erforderlich ist, fordert Google die Nutzer auf, diese 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 standardmäßigen Cloud-Projekten wird automatisch ein Zustimmungsbildschirm über das Apps Script-Projektdetails können Sie diese Einstellungen nicht mehr ändern. Mit Cloud-Standardprojekten passen Sie diese Informationen an. Sie können die Einwilligung Ihres Skripts Bildschirm, indem Sie folgende Schritte ausführen:

  1. Öffnen Sie das Cloud-Projekt.
  2. Klicke auf das Dreistrich-Menü . > APIs und Dienste > Anmeldedaten.
  3. Klicken Sie auf Zustimmungsbildschirm konfigurieren.
  4. Füllen Sie jeden Abschnitt des Workflows für den Zustimmungsbildschirm aus.
  5. Um Ihre Änderungen in jeder Phase des Workflows zu erfassen, klicken Sie auf Speichern und fortfahren.

OAuth-Anmeldedaten erstellen

Apps Script richtet normalerweise OAuth für die Dienste ein die Ihr Skript verwendet. Für einige Anwendungen müssen Sie zusätzliche OAuth-Anmeldedaten (Client-IDs und Clientschlüssel) erstellen. Dies ist nur möglich mit Standardprojekte zu erstellen.

Führen Sie die folgenden Schritte aus, um eine Client-ID und einen Clientschlüssel für Ihr Skriptprojekt zu erstellen: Folgendes:

  1. Öffnen Sie das Cloud-Projekt.
  2. Klicke auf das Dreistrich-Menü . > APIs und Dienste > Anmeldedaten.
  3. Klicken Sie auf Anmeldedaten erstellen > OAuth-Client-ID.
  4. Wählen Sie unter Anwendungstyp Ihren Anwendungstyp und füllen Sie bei Bedarf das entsprechende Formular aus. Klicken Sie abschließend auf Erstellen.
  5. Klicken Sie im angezeigten Dialogfeld auf JSON herunterladen. Sie können Verwenden Sie diese Datei zur Konfiguration von OAuth.

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, hat immer Zugriff auf die Google Cloud-Einstellungen des Skriptprojekts.

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

  1. Bestimme, wer deine Collab-Partner sein sollen. Wir empfehlen Ihnen, eine Google-Gruppe zu erstellen oder eine vorhandene zu verwenden. Sie können geben Sie auch Domains in der Liste der Mitbearbeiter an, um alle Nutzer in dieser .
  2. Öffnen Sie das Cloud-Projekt des Skripts.
  3. Klicke auf das Dreistrich-Menü . > IAM und Administrator > 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 mit einem einzigen Cloud-Projekt gruppieren

Mehrere Apps Script-Projekte können dasselbe Standard-Cloud-Projekt verwenden. Erstellen Sie dazu ein Standardprojekt Jedes Skriptprojekt wechseln um sie zu verwenden. Bei Standardprojekten ist dies nicht möglich.

Ein anderes Standard-Cloud-Projekt verwenden

Sie können ein Skriptprojekt so ändern, dass es einen anderen Standard verwendet Cloud-Projekt Falls für Ihr Skript eine manuelle Konfiguration des Cloud-Projekt zu erstellen, müssen Sie von einem Projekt arbeiten. Weitere Informationen wann Sie ein Standardprojekt verwenden müssen, finden Sie Cloud-Standardprojekte.

Auswirkungen des Wechsels zu einem anderen Cloud-Standardprojekt

Wenn Sie Ihr Script von einem Standardprojekt oder zu einem anderen Standardprojekt ändern 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. Sie verlieren alle Daten, die mit den erweiterten -Dienste im vorherigen Cloud-Projekt. 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 Cloud-Standardprojekt die Drive API:

    Drive API aktivieren

  • Alle Nutzer, die das Skript zuvor autorisiert haben, müssen sich noch einmal autorisieren. In werden in den meisten Fällen alle Nutzer, die bereits Apps autorisiert haben, muss das neue Projekt ebenfalls neu autorisiert werden.
  • 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 und in Ihrem müssen Nutzer deine App neu installieren. Informationen zum Erstellen eines neuen Weitere Informationen zum Veröffentlichen von Apps
  • Sie können ein Skript nicht zurück in ein Standardprojekt zurücksetzen. Apps Script-Löschvorgänge Standardprojekts erstellt werden, nachdem Sie das Skript zur Verwendung eines Standardprojekts konfiguriert haben.

Zu einem anderen Cloud-Standardprojekt wechseln

Vorhandenes Cloud-Projekt eines Skripts auf ein anderes umstellen Cloud-Projekt führen Sie die folgenden Schritte aus:

  1. Wenn Sie kein geeignetes Cloud-Projekt haben, finden Sie unter Projekt erstellen Anleitung. Legen Sie einen einprägsamen Projektnamen fest, Sie finden es in der Google Cloud Console auf der Seite Ressourcen verwalten. Dieser Name wird in Apps Script verwendet, und die Nutzer bitten, 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 ein vorhandenes Projekt. Sie müssen das Die Rollen „Projektbrowser“ und „OAuth-Konfigurationsbearbeiter“ oder entsprechende Rollen Berechtigungen, für die Projekt arbeiten. Sie können kein Projekt verwenden, das automatisch von Apps erstellt wurde Skript.
  3. Bestimmen Sie die Projektnummer Ihres Cloud-Projekts.
  4. Öffnen Sie das Skript, 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 "Team Drive") bieten folgende Vorteile: Freigegebene Gruppenbereiche, in denen Gruppen von Drive-Nutzern an Apps Script zusammenarbeiten können Projekten und Drive-Dokumenten. Geteilte Ablagen sind nützlich für die Entwicklung Skripts, Add-ons und Web-Apps in einem Team, aber sie schränken was Sie mit älteren Cloud-Standardprojekten tun können.

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

  • 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 Ihr Skriptprojekt ein Standardprojekt verwendet, das auf oder können nach dem 8. April 2019 keine weiteren Einschränkungen Projekt befindet sich in einer geteilten Ablage.
  • Wenn Ihr Skriptprojekt ein Standardprojekt verwendet, das vor dem Ab dem 8. April 2019 gelten die folgenden Einschränkungen, während das Skript Projekt befindet sich in einer geteilten Ablage:
    1. Sie können nicht über die Apps Script-Benutzeroberfläche oder in der Google Cloud Console. Diese Einschränkung verhindert, dass Sie Aktionen, die direkten Zugriff auf das Projekt erfordern.
    2. Sie können keine erweiterten Dienste aktivieren. Wechseln Sie zu einem Standarddienst, um erweiterte Dienste zu aktivieren Projekt arbeiten.
    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. Sie können immer noch Sie greifen auf das Standardprojekt zu, wenn Sie vor dem Verschieben Zugriff hatten. Für Beispiel: wenn Sie ein Skript im Ordner „Meine Ablage“ erstellt und dann in einer geteilten Ablage speichern, können Sie weiterhin Cloud-Projekt Dies ist für die Mitbearbeiter der geteilten Ablage möglicherweise nicht möglich.
    4. Ein Skript behält seinen vorherigen Cloud-Projektnamen bei. verschoben nach in einer geteilten Ablage. Auch wenn Sie den Projektnamen in der geteilten Ablage ändern, Nutzer, die das Skript autorisieren, sehen bei der Autorisierung weiterhin den alten Namen. Dialogfeldern angezeigt.

Um die oben genannten Einschränkungen für ältere Skripts zu vermeiden, zu einem Standardprojekt wechseln.

Liste mit Apps Script-Cloud-Projekten abrufen

Wenn Sie die Berechtigung resourcemanager.projects.list für Ihr Apps Script-Projektordners Ihrer Organisation können Sie alle Standard- und Apps Script-Standard-Cloud-Projekte innerhalb des Ordners.

  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 > ID des übergeordneten Elements und fügen Sie Die Apps Script-Ordner-ID

Apps Script-Cloud-Projekte löschen

Um ein Apps Script Cloud-Projekt zu löschen, befolgen Sie die Schritte unter Einen Liste der Apps Script-Cloudprojekte wählen Sie das Projekt aus, das Sie löschen möchten, und klicken Sie auf Löschen.

Wenn Sie ein Apps Script-Projekt mit gcloud löschen möchten, verwenden Sie Folgendes: .

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 Herunterfahren und Herunterfahren Projekte löschen.