Die Bereitstellung eines Apps Script-Projekts ist eine Version des Skripts, die als Webanwendung, Add-on oder ausführbare API zur Verwendung zur Verfügung gestellt wird. Durch das Erstellen und Verwalten von Bereitstellungen können Sie Ihren Code iterieren, Änderungen im Blick behalten und steuern, auf welche Codeversion 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
Eine Head-Bereitstellung 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 Ihren Code ändern, spiegelt die Hauptbereitstellung 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 Nutzung.
Versionierte Bereitstellungen
Eine versionierte Bereitstellung stellt eine bestimmte Version des Projektcodes zur Verfügung. So können Ihre Nutzer weiterhin eine funktionierende Version verwenden, während Sie Änderungen und Verbesserungen am Code vornehmen.
Wenn Ihre Anwendung zur öffentlichen Nutzung veröffentlicht wird, verwenden Sie immer eine versionierte Bereitstellung. Sie können mehrere aktive versionierte Bereitstellungen gleichzeitig haben.
Wichtig: Sie können die Eigentümerschaft versionierter Bereitstellungen nicht übertragen. Wenn Sie die Inhaberschaft eines Skriptprojekts an jemanden übertragen, ändert sich der Inhaber der vorhandenen versionierten Bereitstellungen innerhalb des Projekts nicht. Wenn ein Administrator das Konto des Bereitstellungsinhabers löscht, können Skriptfehler für die Bereitstellungen auftreten.
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 Script vom Standardprojekt auf ein Standardprojekt umstellen.
So erstellen Sie eine versionierte Bereitstellung:
- Öffnen Sie das Apps Script-Projekt.
- Klicken Sie rechts oben auf Bereitstellen > Neue Bereitstellung.
- Klicken Sie neben Typ auswählen auf „Bereitstellungstypen aktivieren“ .
- 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.
Geben Sie die Informationen zu Ihrer Bereitstellung ein und klicken Sie auf Bereitstellen.
Versionierte Bereitstellungen ansehen
Klicken Sie oben auf Bereitstellen > Bereitstellungen verwalten, um die Bereitstellungen eines Apps Script-Projekts anzusehen.
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:
- Öffnen Sie das Apps Script-Projekt.
- Klicken Sie auf Bereitstellen > Bereitstellungen verwalten.
- Wählen Sie die aktive Bereitstellung aus, die Sie ändern möchten, 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, 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 Sie die Bereitstellung, um sie zu verwenden. Die neue Version wird automatisch von allen Nutzern verwendet, die diese Bereitstellung verwenden.
Bereitstellungs-ID finden
Jeder Bereitstellung ist eine String-ID zugeordnet, die automatisch für sie erstellt wird. So finden Sie die ID:
- Öffnen Sie das Apps Script-Projekt.
- Klicken Sie rechts oben auf Bereitstellen > Deployments verwalten.
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.
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-ons testen.
Web-App
Informationen zum Testen einer Bereitstellung für Webanwendungen finden Sie unter Bereitstellung für 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 zuzugreifen.
Sobald 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 Anwendung installieren und testen können.
Ausführbare API
Zum Testen einer ausführbaren API-Bereitstellung müssen Sie zuerst eine versionierte Bereitstellung erstellen. Nachdem Sie eine Bereitstellung erstellt haben, führen Sie die folgenden Schritte aus:
- Klicken Sie rechts oben im Apps Script-Projekt auf Deploy > Test Deployments (Bereitstellen > Deployments testen).
- Klicken Sie neben „Typ auswählen“ auf „Bereitstellungstypen aktivieren“
> API-Ausführbare Datei.
- Kopieren und verwenden Sie die URL, um Ihre ausführbare API-Bereitstellung zu testen.
Versionierte Bereitstellung archivieren
Sie können keine versionierten Bereitstellungen löschen. Sie können sie stattdessen 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, die Sie archivieren möchten, und klicken Sie auf „Bereitstellung archivieren“ .
Archivierte Bereitstellung noch einmal bereitstellen
- Öffnen Sie das Apps Script-Projekt.
- Klicken Sie rechts oben auf Bereitstellen > Deployments verwalten.
- Wählen Sie links unter Archiviert die Bereitstellung aus, die Sie noch einmal bereitstellen möchten, und klicken Sie auf „Bearbeiten“ > Bereitstellen.