Eine Bereitstellung eines Google Apps Script-Projekts ist eine Version des Skripts, die als Web-App, Google Workspace-Add‑on oder API-Ausführbare Datei verwendet werden kann. Durch das Erstellen und Verwalten von Bereitstellungen können Sie Ihren Code iterieren, Änderungen nachverfolgen und die Codeversion steuern, auf die Nutzer zugreifen.
Es gibt zwei Arten von Bereitstellungen:
- Head-Bereitstellungen, die immer mit dem aktuellen Projektcode synchronisiert werden.
- Versionierte Bereitstellungen, die mit einer bestimmten Projektversion verbunden 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 wird 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.
Für jedes Apps Script-Projekt gibt es nur eine Head-Bereitstellung. Wenn Sie eine Head-Bereitstellung verwenden möchten, benötigen Sie mindestens Lesezugriff auf das Scriptprojekt.
Versionierte Bereitstellungen
Bei einer versionierten Bereitstellung ist eine bestimmte Version des Projektcodes verfügbar. So können Nutzer weiterhin eine funktionierende Version verwenden, während Sie Änderungen und Verbesserungen am Code vornehmen.
Wenn Sie eine Anwendung für die öffentliche Nutzung veröffentlichen, verwenden Sie immer eine versionierte Bereitstellung. Sie können mehrere aktive versionierte Deployments gleichzeitig haben.
Wichtig: Die Eigentümerschaft von versionierten Bereitstellungen kann nicht übertragen werden. Wenn Sie die Inhaberschaft für ein Skriptprojekt übertragen, ändert sich der Inhaber der vorhandenen versionierten Bereitstellungen nicht. Wenn ein Administrator das Konto des Bereitstellungsinhabers löscht, können in den Bereitstellungen Skriptfehler auftreten.
Versionierte Bereitstellung erstellen
Wenn Sie eine Version eines Add-ons, eines Editor-Add-ons, einer Chat-App oder einer ausführbaren API bereitstellen möchten, müssen Sie zuerst die Zuordnung des Google Cloud-Projekts Ihres Apps Script vom Standardprojekt zu einem Standardprojekt ändern.
So erstellen Sie ein versioniertes Deployment:
- Öffnen Sie das Apps Script-Projekt. <<../_common/snippets/create-new-deployment.md>>
Jedes neue Deployment kann als Bibliothek freigegeben werden. Wenn Sie das Skript als Bibliothek freigeben, ist die Bereitstellungsbeschreibung für Bibliotheksnutzer sichtbar.
Versionierte Bereitstellungen ansehen
Wenn Sie die Deployments eines Apps Script-Projekts aufrufen möchten, klicken Sie oben auf Bereitstellen > Deployments 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:
- Öffnen Sie das Apps Script-Projekt.
- Klicken Sie auf Bereitstellen > Bereitstellungen verwalten.
- Wählen Sie die aktive Bereitstellung aus und klicken Sie auf Bearbeiten .
- Nehmen Sie die gewünschten Änderungen vor und klicken Sie auf Bereitstellen.
Wenn Sie eine archivierte Bereitstellung bearbeiten möchten, stellen Sie sie noch einmal bereit und folgen Sie dann der Anleitung oben.
Wenn Sie eine Änderung am Projektcode bereitstellen möchten, erstellen Sie eine neue Version und bearbeiten Sie die Bereitstellung, damit sie diese Version verwendet. Bei der Bereitstellung wird automatisch die neue Version für alle Nutzer verwendet.
Bereitstellungs-ID finden
Jeder Bereitstellung ist eine String-ID zugeordnet. So finden Sie die ID:
- Öffnen Sie das Apps Script-Projekt.
- Klicken Sie rechts oben auf Bereitstellen > Bereitstellungen verwalten.
- Wählen Sie eine aktive Bereitstellung aus, um die zugehörige ID zu finden.
Bereitstellungs-IDs werden nur bei aktiven Bereitstellungen angezeigt.
Deployment testen
Die Methode zum Testen einer Bereitstellung hängt vom Typ der App ab, die Sie erstellen.
Google Workspace-Add-on
Informationen zum Testen einer Add-on-Bereitstellung finden Sie unter 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
So testen Sie die Bereitstellung einer Chat-App: Erstellen Sie eine versionierte Bereitstellung des Skripts, 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, erstellen Sie eine versionierte Bereitstellung. Gehen Sie nach dem Erstellen einer Bereitstellung so vor:
- Klicken Sie rechts oben im Apps Script-Projekt auf Bereitstellen > Deployments testen.
- Klicken Sie neben „Typ auswählen“ auf
> API-Ausführbare Datei. - 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:
- Öffnen Sie das Apps Script-Projekt.
- Klicken Sie auf Bereitstellen > Bereitstellungen verwalten.
- Wählen Sie die Bereitstellung aus und klicken Sie auf Bereitstellung archivieren .
Archiviertes Deployment neu bereitstellen
- Öffnen Sie das Apps Script-Projekt.
- Klicken Sie rechts oben auf Bereitstellen > Bereitstellungen verwalten.
- Wählen Sie unter Archiviert das Deployment aus und klicken Sie auf Bearbeiten > Bereitstellen.