Bereitstellungen erstellen und verwalten

Eine Bereitstellung eines Apps Script-Projekts ist eine Version des Scripts, die zur Verwendung als Webanwendung, Add-on oder API-Ausführbares zur Verfügung gestellt wird. Wenn Sie Bereitstellungen erstellen und verwalten, können Sie Ihren Code iterieren, Änderungen im Blick behalten und die genaue Codeversion steuern, auf die Ihre Nutzer Zugriff haben.

Es gibt zwei Arten von Bereitstellungen:

  • Head-Deployments, die immer mit dem aktuellen Projektcode synchronisiert werden.
  • Versionierte Bereitstellungen, die mit einer bestimmten Projektversion verknüpft sind.

Head-Deployments

Ein Head-Deployment ist der aktuelle Projektcode. Wenn Sie ein Apps Script-Projekt erstellen, wird automatisch eine Head-Bereitstellung für dieses Projekt erstellt.

Die Head-Bereitstellung ist immer mit dem zuletzt gespeicherten Code synchronisiert. Wenn Sie beispielsweise eine versionierte Bereitstellung erstellen und dann Ihren Code ändern, werden diese Änderungen in der Head-Bereitstellung berücksichtigt, während die versionierte Bereitstellung unverändert bleibt.

Verwenden Sie Head-Deployments, um Code zu testen. Verwenden Sie keine Head-Bereitstellungen für die öffentliche Nutzung.

Versionsbasierte Bereitstellungen

Bei einer versionierten Bereitstellung wird eine bestimmte Version des Projektcodes verfügbar gemacht. So können Ihre Nutzer weiterhin eine funktionierende Version verwenden, während Sie Änderungen und Verbesserungen am Code vornehmen.

Wenn Ihre Anwendung für die öffentliche Nutzung veröffentlicht wird, verwenden Sie immer eine versionierte Bereitstellung. Sie können mehrere aktive Versions-Deployments gleichzeitig haben.

Wichtig: Die Inhaberschaft von versionierten Bereitstellungen kann nicht übertragen werden. Wenn Sie die Inhaberschaft eines Scriptprojekts an eine andere Person übertragen, ändert sich der Inhaber der vorhandenen versionierten Bereitstellungen im Projekt nicht. Wenn ein Administrator das Konto des Eigentümers der Bereitstellung löscht, kann es bei den Bereitstellungen zu Scriptfehlern kommen.

Versionierte Bereitstellung erstellen

Wenn Sie eine Version eines Google Workspace-Add-ons, eines Editor-Add-ons, einer Google Chat-App oder einer API-Ausführdatei bereitstellen möchten, müssen Sie zuerst die Verknüpfung des Google Cloud-Projekts Ihres Apps Script vom Standardprojekt zu einem Standardprojekt ändern.

So erstellen Sie eine versionierte Bereitstellung:

  1. Öffnen Sie das Apps Script-Projekt.
  2. Klicken Sie rechts oben auf Bereitstellen > Neue Bereitstellung.
  3. Klicken Sie neben Typ auswählen auf „Bereitstellungstypen aktivieren“ .
  4. Wählen Sie die Bereitstellungsart aus, die Sie bereitstellen möchten. Wählen Sie für Google Workspace-Add-ons, Editor-Add-ons und Google Chat-Apps Add-on aus.
  5. Geben Sie die Informationen zur Bereitstellung ein und klicken Sie auf Bereitstellen.

Versionierte Bereitstellungen ansehen

Wenn Sie sich die Bereitstellungen eines Apps Script-Projekts ansehen möchten, klicken Sie oben auf Bereitstellen > Bereitstellungen verwalten.

Wie Sie den Code einer bestimmten Version aufrufen, erfahren Sie unter Frühere Version aufrufen.

Versionierte Bereitstellung bearbeiten

Sie können eine versionierte Bereitstellung bearbeiten, um die Beschreibung oder Version zu ändern. So bearbeiten Sie eine Bereitstellung:

  1. Öffnen Sie das Apps Script-Projekt.
  2. Klicken Sie auf Bereitstellen > Bereitstellungen verwalten.
  3. Wählen Sie die aktive Bereitstellung aus, die Sie ändern möchten, und klicken Sie auf „Bearbeiten“ .
  4. Nehmen Sie die Änderungen vor und klicken Sie auf Bereitstellen.

    Wenn Sie eine archivierte Bereitstellung bearbeiten möchten, müssen Sie sie neu bereitstellen und dann die vorherigen Schritte ausführen.

    Wenn Sie eine Änderung am Projektcode bereitstellen möchten, erstellen Sie eine neue Version und bearbeiten Sie die Bereitstellung, um sie zu verwenden. Die neue Version wird automatisch von allen Nutzern verwendet, die diese Bereitstellung nutzen.

Bereitstellungs-ID ermitteln

Jede Bereitstellung hat eine automatisch erstellte String-ID. So finden Sie diese ID:

  1. Öffnen Sie das Apps Script-Projekt.
  2. Klicken Sie rechts oben auf Bereitstellen > Bereitstellungen verwalten.
  3. Wählen Sie eine aktive Bereitstellung aus, um die ID zu sehen.

    Bereitstellungs-IDs werden nur bei aktiven Bereitstellungen angezeigt.

Bereitstellung testen

Wie Sie eine Bereitstellung testen, hängt von der Art der App ab, die Sie erstellen.

Google Workspace-Add-on

Informationen zum Testen einer Google Workspace-Add-on-Bereitstellung finden Sie unter Google Workspace-Add-ons testen.

Editor-Add-on

Informationen zum Testen einer Editor-Add-on-Bereitstellung finden Sie unter Editor-Add-on testen.

Web-App

Informationen zum Testen einer Webanwendungsbereitstellung finden Sie unter Bereitstellung einer Webanwendung testen.

Google Chat App

Wenn Sie die Bereitstellung einer Chat-App testen möchten, müssen Sie zuerst eine versionierte Bereitstellung des Scripts erstellen, um auf die Bereitstellungs-ID zuzugreifen.

Geben Sie die Bereitstellungs-ID in der Chat API-Konfiguration an und folgen Sie der Anleitung zum Testen interaktiver Funktionen.

Ausführbare API

Wenn Sie eine ausführbare API-Bereitstellung testen möchten, müssen Sie zuerst eine versionierte Bereitstellung erstellen. Führen Sie nach dem Erstellen eines Deployments die folgenden Schritte aus:

  1. Klicken Sie rechts oben im Apps Script-Projekt auf Bereitstellen > Bereitstellungen testen.
  2. Klicken Sie neben „Typ auswählen“ auf „Deployment-Typen aktivieren“  > „API-Ausführbare Datei“.
  3. Kopieren Sie die URL und verwenden Sie sie, um die Bereitstellung der ausführbaren API zu testen.

Versionierte Bereitstellung archivieren

Versionierte Bereitstellungen können nicht gelöscht werden. Stattdessen können Sie sie archivieren.

So archivieren Sie eine versionierte Bereitstellung:

  1. Öffnen Sie das Apps Script-Projekt.
  2. Klicken Sie auf Bereitstellen > Bereitstellungen verwalten.
  3. Wählen Sie die Bereitstellung aus, die Sie archivieren möchten, und klicken Sie auf „Bereitstellung archivieren“ .

Archivierte Bereitstellung neu bereitstellen

  1. Öffnen Sie das Apps Script-Projekt.
  2. Klicken Sie rechts oben auf Bereitstellen > Bereitstellungen verwalten.
  3. Wählen Sie links unter Archiviert die Bereitstellung aus, die Sie neu bereitstellen möchten, und klicken Sie auf „Bearbeiten“  > Bereitstellen.