Bereitstellungen erstellen und verwalten

Eine Apps Script-Projektbereitstellung ist eine Version des Skripts, die als Webanwendung, Add-on oder ausführbare API verwendet werden kann. Durch das Erstellen und Verwalten von Bereitstellungen können Sie Ihren Code iterieren, Ihre Änderungen verfolgen 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 verbunden sind.

Head-Bereitstellungen

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

Die Head-Bereitstellung ist immer mit dem zuletzt gespeicherten Code synchronisiert. Wenn Sie beispielsweise eine versionierte Bereitstellung erstellen und dann den Code ändern, spiegelt die Head-Bereitstellung diese Änderungen wider, während die versionierte Bereitstellung intakt bleibt.

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

Versionierte Bereitstellungen

Bei einer versionierten Bereitstellung wird eine bestimmte Version des Projektcodes zur Verfügung gestellt. So können Ihre Nutzer weiterhin eine funktionsfähige Version verwenden, während Sie Änderungen und Verbesserungen am Code vornehmen.

Wenn Ihre Anwendung öffentlich verfügbar ist, sollten Sie immer eine versionierte Bereitstellung verwenden. Sie können mehrere aktive versionierte Bereitstellungen gleichzeitig haben.

Wichtig: Sie können die Inhaberschaft von versionierten Bereitstellungen nicht übertragen. Wenn Sie die Inhaberschaft eines Skriptprojekts auf jemanden übertragen, ändert sich der Inhaber der vorhandenen versionierten Bereitstellungen innerhalb des Projekts nicht. Wenn ein Administrator das Konto des Bereitstellungsinhabers löscht, treten möglicherweise Skriptfehler für dessen Bereitstellungen auf.

Versionierte Bereitstellung erstellen

Wenn Sie eine Version eines Google Workspace-Add-ons, eines Editor-Add-ons, einer Google Chat-App oder einer ausführbaren API bereitstellen möchten, müssen Sie zuerst die Google Cloud-Projektverknüpfung Ihres Apps Scripts vom Standardprojekt auf ein Standardprojekt umstellen.

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 den Bereitstellungstyp aus, den Sie bereitstellen möchten. Wählen Sie für Google Workspace-Add-ons, Editor-Add-ons und Google Chat-Anwendungen die Option Add-on aus.
  5. Geben Sie die Informationen zu Ihrer 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.

Informationen zum Anzeigen des Codes einer bestimmten Version finden Sie unter Vorherige Version ansehen.

Versionierte Bereitstellung bearbeiten

Sie können eine versionierte Bereitstellung bearbeiten, um ihre 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 gewünschten Änderungen vor und klicken Sie auf Bereitstellen.

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

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

Bereitstellungs-ID finden

Jeder Bereitstellung ist automatisch eine String-ID zugeordnet. 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 ihre ID zu ermitteln.

    Bereitstellungs-IDs werden nur in aktiven Bereitstellungen angezeigt.

Bereitstellung testen

Wie Sie eine Bereitstellung testen, hängt vom Typ der erstellten Anwendung ab.

Add-on für Google Workspace

Informationen zum Testen der Bereitstellung eines Google Workspace-Add-ons finden Sie unter Google Workspace-Add-ons testen.

Editor-Add-on

Informationen zum Testen der Bereitstellung eines Editor-Add-ons finden Sie unter Editor-Add-on testen.

Web-App

Informationen zum Testen einer Webanwendungsbereitstellung finden Sie unter Bereitstellung von Webanwendungen testen.

Google Chat App

Wenn Sie die Bereitstellung einer Chat-App testen möchten, müssen Sie zuerst eine versionierte Bereitstellung des Skripts erstellen, um auf die Bereitstellungs-ID zugreifen zu können.

Wenn Sie die Bereitstellungs-ID haben, führen Sie die Schritte zum Aktivieren der Google Chat API aus. Geben Sie auf der Konfigurationsseite unter „Berechtigungen“ nur Ihre E-Mail-Adresse an, damit Sie Ihre App installieren und testen können.

Ausführbare API

Wenn Sie eine mit der API ausführbare Bereitstellung testen möchten, müssen Sie zuerst eine versionierte Bereitstellung erstellen. Nachdem Sie eine Bereitstellung erstellt haben, führen Sie die folgenden Schritte aus:

  1. Klicken Sie rechts oben im Apps Script-Projekt auf Bereitstellen > Deployments testen.
  2. Klicken Sie neben „Typ auswählen“ auf „Bereitstellungstypen aktivieren“ > API Executable.
  3. Kopieren Sie die URL und verwenden Sie sie, um Ihre API Executable-Bereitstellung zu testen.

Versionierte Bereitstellung archivieren

Sie können versionierte Bereitstellungen nicht löschen. 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 noch einmal 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 noch einmal bereitstellen möchten, und klicken Sie auf „Bearbeiten“ > Bereitstellen.