Eine Google Apps Script-Projektbereitstellung ist eine Version Ihres Skripts, die als Webanwendung, Google Workspace-Add‑on oder ausführbare API verwendet werden kann. Durch das Erstellen und Verwalten von Bereitstellungen können Sie Ihren Code iterativ weiterentwickeln und steuern, auf welche Skriptversion 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-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 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 übernommen, während die versionierte Bereitstellung unverändert bleibt.
Verwenden Sie Head-Bereitstellungen, um Code zu testen. Head-Bereitstellungen sind nicht für die öffentliche Nutzung geeignet.
Für jedes Apps Script-Projekt gibt es nur eine Head-Bereitstellung. Um eine Head-Bereitstellung zu verwenden, benötigen Sie mindestens Lesezugriff auf das Skriptprojekt.
Versionierte Bereitstellungen
Mit einer versionierten Bereitstellung wird eine bestimmte Version des Projektcodes verfügbar gemacht. So können Nutzer 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 Bereitstellungen gleichzeitig haben.
Wichtig: Die Inhaberschaft von versionierten Bereitstellungen kann nicht übertragen werden. Wenn Sie die Inhaberschaft eines Skriptprojekts übertragen, ändert sich der Inhaber der vorhandenen versionierten Bereitstellungen nicht. Wenn ein Administrator das Konto des Bereitstellungsinhabers löscht, kann es bei den Bereitstellungen zu Skriptfehlern kommen.
Bereitstellungen im Vergleich zu Versionen
Eine Version und eine Bereitstellung sind in Apps Script unterschiedliche Konzepte:
- Version: Eine statische Momentaufnahme des Codes Ihres Skriptprojekts. Nach der Erstellung kann eine Version nicht mehr geändert werden. Eine Version ist wie ein Speicherpunkt in Ihrem Entwicklungsverlauf.
- Bereitstellung: Eine Version, mit der eine bestimmte Version Ihres Skripts für Nutzer verfügbar gemacht wird. Eine Bereitstellung hat eine eindeutige URL oder ID.
Wenn Sie den Code aktualisieren möchten, der von einer vorhandenen Bereitstellung verwendet wird (z. B. einer Web anwendung), erstellen Sie eine neue Version und bearbeiten dann die Bereitstellung, um auf diese neue Version zu verweisen. Dadurch wird die Anwendung für alle Nutzer aktualisiert, während die URL oder Bereitstellungs-ID gleich bleibt.
Versionierte Bereitstellung erstellen
Wenn Sie eine Version eines Add‑ons, Editor-Add‑ons, einer Chat-App oder einer ausführbaren API bereitstellen möchten, müssen Sie zuerst die Google Cloud-Projektzuordnung Ihres Apps Script vom Standardprojekt zu einem Standardprojekt ändern.
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 die Einstellungen für 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 Add‑on aus.
- Geben Sie die Informationen zur Bereitstellung ein und klicken Sie auf Bereitstellen.
Jede neue Bereitstellung 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 Bereitstellungen eines Apps Script-Projekts ansehen möchten, klicken Sie oben auf Bereitstellen > Bereitstellungen verwalten.
Informationen zum Ansehen des Codes einer bestimmten Version finden Sie unter Frühere Version ansehen.
Versionierte Bereitstellung bearbeiten
Sie können eine versionierte Bereitstellung bearbeiten, um die 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 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 führen Sie dann die oben genannten Schritte aus.
Wenn Sie eine Änderung am Projektcode bereitstellen möchten, erstellen Sie eine neue Version und bearbeiten Sie die Bereitstellung, um sie zu verwenden. Dies ist die Standardmethode zum Aktualisieren Ihrer Anwendung, ohne die URL oder Bereitstellungs-ID zu ändern. Die Bereitstellung verwendet automatisch die neue Version für alle Nutzer.
Bereitstellungs-ID finden
Jede Bereitstellung hat eine zugehörige String-ID. 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 die ID zu finden.
Bereitstellungs-IDs werden nur für aktive Bereitstellungen angezeigt.
Bereitstellung 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 einer Editor-Add‑on-Bereitstellung finden Sie unter Editor-Add‑on testen.
Webanwendung
Informationen zum Testen einer Webanwendungsbereitstellung finden Sie unter Webanwendungsbereitstellung testen.
Google Chat-App
Wenn Sie eine Chat-App-Bereitstellung testen möchten, erstellen Sie eine versionierte Bereitstellung des Skripts, um auf die Bereitstellungs-ID zuzugreifen.
Nachdem Sie die Bereitstellungs-ID haben, geben Sie sie in der Chat API-Konfiguration an und folgen Sie der Anleitung zum Testen interaktiver Features.
Ausführbare API
Wenn Sie eine Bereitstellung einer ausführbaren API testen möchten, erstellen Sie eine versionierte Bereitstellung. Führen Sie nach dem Erstellen einer Bereitstellung die folgenden Schritte aus:
- Klicken Sie rechts oben im Apps Script-Projekt auf Bereitstellen > Bereitstellungen.
- Klicken Sie neben „Typ auswählen“ auf
> Ausführbare API. - Kopieren Sie die URL und verwenden Sie sie, um die Bereitstellung der ausführbaren API zu testen.
Versionierte Bereitstellung archivieren
Sie können versionierte Bereitstellungen nicht aus Ihrer Liste der Bereitstellungen löschen. 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 .
Version aus dem Projektverlauf löschen
Sie können versionierte Bereitstellungen zwar nicht löschen, aber die Skriptversionen, die sie verwenden, aus Ihrem Projektverlauf löschen. Damit Sie eine Version löschen können, darf sie nicht von einer aktiven Bereitstellung verwendet werden.
Informationen zum Löschen einer Version finden Sie unter Versionen löschen.
Archivierte Bereitstellung noch einmal bereitstellen
- Öffnen Sie das Apps Script-Projekt.
- Klicken Sie rechts oben auf Bereitstellen > Bereitstellungen verwalten.
- Wählen Sie unter Archiviert die Bereitstellung aus und klicken Sie auf Bearbeiten > Bereitstellen.