Eine Bereitstellung des Apps Script-Projekts ist eine Version des Skripts, die als Webanwendung, Add-on oder ausführbare API zur Verfügung gestellt wird. Durch das Erstellen und Verwalten von Bereitstellungen können Sie Code iterieren, Änderungen im Blick behalten und die genaue Codeversion steuern, auf die 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 verbunden sind.
Head-Bereitstellungen
Eine Head-Bereitstellung 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 zum Beispiel eine versionierte Bereitstellung erstellen und dann Ihren Code ändern, werden diese Änderungen von der Head-Bereitstellung übernommen, während die versionierte Bereitstellung unverändert bleibt.
Verwenden Sie Kopfbereitstellungen, um Code zu testen. Verwenden Sie Head-Bereitstellungen nicht für die öffentliche Nutzung.
Versionierte Bereitstellungen
Bei einer versionierten Bereitstellung wird eine bestimmte Version des Projektcodes zur Verfügung gestellt. So können Ihre Nutzer weiterhin eine funktionierende Version verwenden, während Sie Änderungen 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 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 Deployment-Inhabers löscht, können für seine Deployments Skriptfehler auftreten.
Versionierte Bereitstellung erstellen
Wenn Sie das Skript als Add-on oder eine ausführbare API-Datei bereitstellen möchten, müssen Sie zuerst die Google Cloud-Projektverknüpfung Ihres Apps Script vom Standardprojekt auf das 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.
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 auf Bereitstellen > Bereitstellungen verwalten.
Versionierte Bereitstellung bearbeiten
Sie können eine versionierte Bereitstellung bearbeiten, um ihren Namen oder ihre Version zu ändern. So bearbeiten Sie eine Bereitstellung:
- Öffnen Sie das Apps Script-Projekt.
- Klicken Sie rechts oben 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 oben genannten 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.
Archivierte Bereitstellung noch einmal bereitstellen
- Öffnen Sie das Apps Script-Projekt.
- Klicken Sie rechts oben auf Bereitstellen > Bereitstellungen verwalten.
- Wählen Sie links unter Archiviert das Deployment aus, das Sie noch einmal bereitstellen möchten, und klicken Sie auf „Bearbeiten“ > Bereitstellen.
Bereitstellungs-ID finden
Jedem Deployment ist automatisch eine String-ID zugeordnet. So finden Sie diese ID:
- Öffnen Sie das Apps Script-Projekt.
- Klicken Sie rechts oben auf Bereitstellen > Bereitstellungen 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 einer Google Workspace-Add-on-Bereitstellung finden Sie unter Google Workspace-Add-ons testen.
Editor-Add-on
Informationen zum Testen eines Editor-Add-ons finden Sie unter Editor-Add-on testen.
Web-App
Informationen zum Testen der Bereitstellung einer Webanwendung finden Sie unter Bereitstellung einer Webanwendung testen.
Chat App
Zum Testen der Bereitstellung einer Chat-App müssen Sie zuerst eine versionierte Bereitstellung des Skripts erstellen, um auf die Bereitstellungs-ID zuzugreifen.
Sobald Sie die Bereitstellungs-ID haben, folgen Sie der Anleitung zum Aktivieren der Google Chat API. 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. Führen Sie nach dem Erstellen einer Bereitstellung die folgenden Schritte aus:
- Klicken Sie rechts oben im Apps Script-Projekt auf Deploy > Test Deployments.
- Klicken Sie neben „Typ auswählen“ auf „Bereitstellungstypen aktivieren“
> Ausführbare API.
- Kopieren und verwenden Sie die URL, um die ausführbare API-Bereitstellung zu testen.
Versionierte Bereitstellung löschen
In der neuesten IDE können Sie Bereitstellungen nur archivieren, nicht löschen.
- Öffnen Sie das Apps Script-Projekt.
- Klicken Sie rechts oben auf Bereitstellen > Bereitstellungen verwalten.
- Wählen Sie das Deployment aus, das Sie archivieren möchten, und klicken Sie auf „Deployment archivieren“ .