Bereitstellungen erstellen und verwalten

Eine Bereitstellung eines Apps Script-Projekts ist eine Version des Skripts, die als Webanwendung, Add-on oder API-Ausführung zur Verfügung gestellt wird. Durch das Erstellen und Verwalten von Bereitstellungen können Sie Ihren Code iterieren, Änderungen nachverfolgen und die genaue Codeversion steuern, auf die Ihre Nutzer Zugriff haben.

Es gibt zwei Arten von Bereitstellungen:

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

Head-Deployments

Bei einem Head-Deployment handelt es sich um den aktuellen 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.

Versionierte 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, sollten Sie immer eine versionierte Bereitstellung verwenden. Sie können mehrere aktive versionierte Deployments gleichzeitig haben.

Wichtig: Die Eigentümerschaft von versionierten Bereitstellungen kann nicht übertragen werden. Wenn Sie die Inhaberschaft eines Scriptprojekts auf eine andere Person übertragen, ändert sich der Inhaber der vorhandenen versionierten Bereitstellungen im Projekt nicht. Wenn ein Administrator das Konto des Bereitstellungsinhabers löscht, können bei den Bereitstellungen des Nutzers Skriptfehler auftreten.

Versioniertes Deployment 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 Verknüpfung Ihres Apps Script-Projekts mit dem Google Cloud-Projekt vom Standardprojekt zu einem Standardprojekt ändern.

So erstellen Sie ein versioniertes Deployment:

  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-Apps die Option Add-on aus.
  5. Geben Sie die Informationen zu Ihrer Bereitstellung ein und klicken Sie auf Bereitstellen.

Versionierte Bereitstellungen ansehen

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

Informationen zum Aufrufen des Codes einer bestimmten Version finden Sie unter Frühere Version ansehen.

Versioniertes Deployment bearbeiten

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

  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 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 finden

Für jede Bereitstellung wird automatisch eine zugehörige String-ID erstellt. 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 zugehörige ID zu finden.

    Bereitstellungs-IDs werden nur bei aktiven Bereitstellungen angezeigt.

Deployment testen

Wie Sie eine Bereitstellung testen, hängt vom Typ der App ab, die Sie entwickeln.

Google Workspace-Add-on

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 der Bereitstellung einer Web-App finden Sie unter Bereitstellung einer Web-App testen.

Google Chat App

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

Nachdem Sie die Bereitstellungs-ID erhalten haben, geben Sie sie 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. Nachdem Sie ein Deployment erstellt haben, gehen Sie so vor:

  1. Klicken Sie rechts oben im Apps Script-Projekt auf Bereitstellen > Bereitstellungen testen.
  2. Klicken Sie neben „Typ auswählen“ auf „Bereitstellungstypen 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 das Deployment aus, das Sie archivieren möchten, und klicken Sie auf „Deployment archivieren“ .

Archiviertes Deployment 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 das Deployment aus, das Sie noch einmal bereitstellen möchten, und klicken Sie auf „Bearbeiten“  > Bereitstellen.