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, erstellt Apps Script eine Standard- Cloud-Projekt, 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 Skripts 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

Cloud-Standardprojekte ansehen oder aktualisieren

Die meisten Nutzer können Standardprojekte im Google Cloud Console Weitere Informationen für Administratoren finden Sie im Hilfeartikel Google Cloud-Standardprojekte 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 Skript 180 Tage oder länger nicht ausgeführt wird, löscht das zugehörige Standardprojekt. Wenn das Skript ausgeführt wird nach Apps Script löscht sein Standardprojekt, Apps Script erstellt ein Projekt für das .

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.

Wenn Apps Script Cloud-Standardprojekte erfordert

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

Standard-Cloud-Projektattribute

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 Skriptprojekt löschen oder auf 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 Skriptprojekte und andere Apps können denselben Namen verwenden Standardprojekt. Wenn Sie ein Skriptprojekt veröffentlichen möchten zu den Google Workspace Marketplace als Add-on verwenden, muss ein eigenes Standardprojekt vorhanden sein. Veröffentlichte Apps können nicht geteilt werden Cloud-Projekte mit anderen Anwendungen.
  • 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 Apps Script einen Nutzer auffordert, ein Script zu autorisieren, wird der Name des Cloud-Projekts zur Identifizierung des Skripts (nicht der Name des Skriptprojekts). Legen Sie daher einen geeigneten Name des Cloud-Projekts.

Auf ein Cloud-Standardprojekt 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 Cloud-Standardprojekt aktivieren

Häufig 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 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 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: Nutzungsbedingungen lesen der Nutzungsbedingungen sorgfältig akzeptieren, 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. Scrollen Sie nach unten zum Abschnitt Vorgänge, um Fehlerberichte anzusehen. und klicken Sie auf Error Reporting. 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 Dienstleistungen. In den Einstellungen für den OAuth-Zustimmungsbildschirm können Sie die Google den 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) 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 Cloud-Standardprojekt 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.

Sie können zusätzliche Inhaber oder andere Rollen zu einem Standardprojekt hinzufügen, indem Sie folgen. 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 ein oder mehrere neue Mitglieder für das Cloud-Projekt zuweisen. 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

Sie können für mehrere Apps Script-Projekte denselben Standard verwenden Cloud-Projekt Erstellen Sie dazu ein Standardprojekt jedes Skriptprojekt wechseln um sie zu verwenden. Bei Standardprojekten ist dies nicht möglich.

Anderes Cloud-Standardprojekt 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 Skript aktiviert haben, müssen Sie den entsprechende APIs in das neue Cloud-Projekt. Sie verlieren alle Daten, die mit den erweiterten -Dienste im vorherigen Cloud-Projekt. Weitere Informationen zum Aktivieren von APIs Informationen in Ihrem Cloud-Projekt finden Sie unter Google Workspace APIs aktivieren.
  • Wenn Ihr Skript den integrierten Google Drive-Dienst verwendet, müssen Sie den Drive API in Cloud-Standardprojekten

    Aktivieren Sie in Ihrem Cloud-Standardprojekt die Drive API:

    <ph type="x-smartling-placeholder"></ph> 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 Skript mit einem App-Eintrag im Google Workspace Marketplace verknüpft ist, werden Ihr App-Eintrag, die Nutzer und die Rezensionen nicht in den für ein neues Projekt erstellen. 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 Set Project (Projekt festlegen).

Cloud-Projekte und geteilte Ablagen

Geteilte Ablagen (früher "Team Drives") bieten 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 Ihr Skriptprojekt ein Standardprojekt verwendet, sind keine zusätzliche Einschränkungen, wenn sich das Skriptprojekt in einer geteilten 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: <ph type="x-smartling-placeholder">
      </ph>
    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 bestehendes Apps Script-Projekt in eine geteilte Ablage verschieben, schränkt den Zugriff auf das Cloud-Standardprojekt 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 &gt; 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