Wenn Sie bereits ein Add-on zur Erweiterung von Gmail oder Kalender erstellt und veröffentlicht haben, können Sie ein Upgrade auf ein Google Workspace-Add-on ausführen. In der Anleitung auf dieser Seite wird beschrieben, wie Sie vorhandenen Gmail- oder Kalender-Add-ons Google Workspace-Funktionen hinzufügen und anschließend das aktualisierte Add-on veröffentlichen, damit es gefunden und installiert werden kann.
Sie können die neuen Funktionen in das ursprüngliche Add-on übertragen, um Ihren Google Workspace Marketplace-Eintrag, Ihre Installationen und Ihre Nutzer beizubehalten. Außerdem können Sie neue Google Workspace-Add-on-Funktionen wie Startseiten nutzen.
Schritt 1: Apps Script-Projekt des Add-ons kopieren
Das aktualisierte Add-on verwendet dasselbe Google Cloud-Projekt wie das veröffentlichte Add-on. Es ist jedoch wichtig, eine Kopie des zugrunde liegenden Apps Script-Projekts zu erstellen und zu verwenden, damit Ihre vorhandenen Nutzer während des Testens der aktualisierten Version nicht beeinträchtigt werden. Wenn Sie eine Kopie des ursprünglichen Skriptprojekts aktualisieren, können Sie jederzeit auf den ursprünglichen Code zugreifen und ihn bei Bedarf später neu bereitstellen.
- Öffnen Sie Ihr vorhandenes Gmail-Add-on oder Ihr Apps Script-Add-on-Add-on für Kalender-Konferenzen in Apps Script.
- Klicken Sie links auf Übersicht .
- Klicken Sie rechts auf „Kopie erstellen“ .
- Klicken Sie links auf Projekteinstellungen > Projekt ändern.
- Klicken Sie auf GCP-Projektnummer.
- Geben Sie dieselbe Projektnummer ein, die Ihrem vorhandenen, veröffentlichten Add-on-Add-on-Projekt in Apps Script zugeordnet ist.
- Klicken Sie auf Projekt festlegen.
Schritt 2: Google Workspace-Add-on einbinden
Sie müssen alle Google Workspace-Add-on-Funktionen, die Sie dem Add-on hinzufügen möchten, entwerfen und implementieren.
- Planen Sie, welche Inhalte auf den Karten auf der Startseite des Add-ons angezeigt werden sollen und ob sie in Gmail, Google Kalender, Google Drive oder einer beliebigen Kombination der drei Hosts angezeigt werden sollen. Wenn Sie eine Startseite auf mehreren Hosts haben möchten, entscheiden Sie, ob es sich um dieselbe Startseite handelt oder ob Sie für jeden Host benutzerdefinierte Startseitenkarten verwenden möchten.
- Erstellen Sie im kopierten Apps Script-Add-on-Projekt Ihre Startseitenkarten mit
homepageTrigger-Funktionen. Binden Sie alle unterstützenden Funktionen oder Logiken ein, die für die Steuerung der neuen Startseitenoberflächen erforderlich sind. Sie können kontextbezogene Karten hinzufügen, die durch eine Nutzeraktion ausgelöst werden, z. B. das Öffnen eines Gmail-Nachrichtenthreads oder eines Kalendertermins.
Aktualisieren Sie den Zugriff auf Ereignisobjekte in Ihrem Add-on (in Widget-Callback-Funktionen oder in kontextbezogenen Triggerfunktionen), sodass die aktualisierte Ereignisobjektstruktur verwendet wird. Die neue Struktur enthält weiterhin dieselben Felder für Terminobjekte, die von den Gmail- und Kalender-Add-ons für Videokonferenzen verwendet werden. Diese ursprünglichen Felder wurden jedoch verworfen und werden irgendwann entfernt.
Schritt 3: Manifest des Add-ons aktualisieren
Die Art und Weise, wie Konfigurationsinformationen in der Manifeststruktur von Google Workspace-Add-ons gespeichert werden, hat sich gegenüber der Struktur von Gmail-Add-ons und Kalender-Konferenz-Add-ons erheblich geändert. Wenn Sie ein Upgrade für Ihr Add-on durchführen, müssen Sie die Manifestfelder des Apps Script-Projekts im Add-on gemäß den folgenden Tabellen aktualisieren. Sie müssen alle relevanten untergeordneten Properties auf die neue addOns-Property aktualisieren.
Aktualisieren Sie auch das Feld oauthScopes Ihres Manifests, um die Berechtigungen zu berücksichtigen, die für das aktualisierte Add-on erforderlich sind.
Weitere Informationen zu Manifesten des Google Workspace-Add-ons finden Sie unter Manifeste.
Gmail-Add-ons
| Ursprüngliches Manifestfeld | Wichtige Informationen |
|---|---|
gmail.composeTrigger |
Verschieben nach addOns.gmail.composeTrigger. |
gmail.contextualTriggers[] |
Verschieben Sie die Liste nach addOns.gmail.contextualTriggers[]. |
gmail.logoUrl |
Verschieben nach addOns.common.logoUrl. |
gmail.name |
Verschieben nach addOns.common.name. |
gmail.openLinkUrlPrefixes[] |
Verschieben Sie die Liste nach addOns.common.openLinkUrlPrefixes[].
|
gmail.primaryColor |
Verschieben nach addOns.common.layoutProperties.primaryColor. |
gmail.secondaryColor |
Verschieben nach addOns.common.layoutProperties.secondaryColor.
|
gmail.universalActions[] |
Verschieben Sie die Liste nach addOns.common.universalActions[]. |
gmail.universalActions[].text |
Verschieben Sie jedes gmail.universalActions[].text-Feld in das entsprechende addOns.common.universalActions[].label-Feld. |
gmail.useLocalFromApp |
Verschieben nach addOns.common.useLocaleFromApp. |
Add-ons für Google Kalender-Videokonferenzen
| Ursprüngliches Manifestfeld | Wichtige Informationen |
|---|---|
calendar.createSettingsUrlFunction |
Verschieben nach addOns.calendar.createSettingsUrlFunction. |
calendar.conferenceSolution[] |
Verschieben nach addOns.calendar.conferenceSolution[]. |
calendar.logoUrl |
Verschieben nach addOns.common.logoUrl. |
calendar.name |
Verschieben nach addOns.common.name. |
Schritt 4: Aktualisiertes Add-on testen
Wie Sie das aktualisierte Add-on vor der Veröffentlichung testen, erfahren Sie unter Google Workspace-Add-ons testen.
Schritt 5: Überprüfung des aktualisierten Add-ons beantragen
Alle Google Workspace-Add-ons müssen genehmigt werden, bevor sie im Google Workspace Marketplace aufgeführt werden können. Das gilt sowohl für Add-ons mit Upgrade als auch für neu erstellte Add-ons.
So reichen Sie Ihr Add-on zur Überprüfung ein:
Achten Sie darauf, dass Ihr Add-on alle Anforderungen für die Veröffentlichung von Add-ons erfüllt.
Erstellen Sie im neuen Apps Script-Projekt eine versionierte Bereitstellung des Google Workspace-Add-ons mit der Version des Codes, den Sie veröffentlichen möchten. Versuchen Sie nicht, mit einem Head-Deployment zu veröffentlichen.
Wenn Sie beim Upgrade des Add-ons neue Bereiche hinzugefügt haben, müssen Sie die OAuth-Überprüfung anfordern. Wenn Ihr Gmail-Add-on beispielsweise neue Drive- oder Kalenderbereiche in der Version des Google Workspace-Add-ons verwendet, müssen Sie diese neuen Bereiche zur Überprüfung einreichen. Die Überprüfung dauert in der Regel einige Tage. Beginnen Sie den Prozess daher so früh wie möglich. Vergewissern Sie sich, dass Ihr Add-on verifiziert ist, bevor Sie mit Schritt 6 fortfahren.
Schritt 6: Aktualisiertes Add-on verfügbar machen
Öffnen Sie das Google Workspace Marketplace SDK.
Klicken Sie links auf Konfiguration. Dieser Bereich enthält ein Formular, in dem Sie Informationen zu Ihrem Add-on angeben.
Aktualisieren Sie die Kurzbeschreibung, die detaillierte Beschreibung und die Screenshots Ihres Eintrags, um die neuen Funktionen des Google Workspace-Add-ons widerzuspiegeln.
Klicken Sie unter Erweiterungen auf die Schaltfläche Upgrade auf Google Workspace-Add-on. Geben Sie in das angezeigte Textfeld die neue Bereitstellungs-ID ein, die Sie im vorherigen Schritt für das Google Workspace-Add-on erstellt haben. Wenn Ihre Bereitstellungs-ID gültig ist, wird eine Liste der unterstützten Hosts angezeigt.
Wenn Sie Ihrem Google Workspace-Add-on neue Bereiche hinzugefügt haben, müssen Sie diese auf der Seite Konfiguration im Abschnitt OAuth 2.0-Bereiche hinzufügen. Die in diesem Abschnitt aufgeführten Bereiche müssen genau mit den im Manifest des Add-ons aufgeführten Bereichen übereinstimmen.
Prüfen Sie, ob die Informationen, die Sie in das Formular eingegeben haben, korrekt sind. Klicken Sie dann auf Änderungen speichern.
Wenn Sie Fragen haben oder während des Upgrades des Google Workspace-Add-ons Probleme auftreten, kontaktieren Sie uns.
Häufig gestellte Fragen
Im Folgenden finden Sie häufig gestellte Fragen zu Add-on-Upgrades:
Kann ich mein Editor-Add-on aktualisieren?
Die meisten Editor-Add-ons können in Google Workspace-Add-ons verschoben werden. Ein Upgrade auf Google Workspace-Add-ons ist jedoch nicht so einfach wie Add-ons für Gmail und Google Kalender.
Wenn du dein Editor-Add-on zu einem Google Workspace-Add-on migrieren möchtest, musst du die UI des Add-ons von HTML in eine kartenbasierte Oberfläche umschreiben und deine JavaScript-Verarbeitung auf den Kartendienst aktualisieren.
Einige Dienste in deinem bestehenden Editor-Add-on sind möglicherweise nicht im Kartendienst verfügbar. Wenn Ihr Editor-Add-on beispielsweise eine Dateiauswahl enthält, ist im Kartendienst für Google Workspace-Add-ons kein Äquivalent verfügbar.
Kann ich ein separates Google Workspace-Add-on erstellen und mein vorhandenes Add-on behalten?
Sie können gern zusätzliche Google Workspace-Add-ons unter verschiedenen Markennamen erstellen. Separate Gmail- oder Kalender-Add-ons für Videokonferenzen unter demselben Markennamen wie Ihr Google Workspace-Add-on sind jedoch nicht zulässig. Wenn Sie Fragen haben oder eine Ausnahme beantragen möchten, wenden Sie sich an uns.
Müssen meine Nutzer das Add-on nach dem Upgrade noch einmal autorisieren?
Solange Ihr Google Workspace-Add-on dasselbe zugrunde liegende GCP-Projekt (Cloud Platform) mit einer verknüpften OAuth-Client-ID verwendet, müssen Ihre Nutzer Berechtigungen, die sie zuvor für das ursprüngliche Add-on autorisiert haben, nicht noch einmal autorisieren. Wenn Sie jedoch während des Upgradeprozesses neue Bereiche hinzufügen, müssen Ihre Nutzer diese neuen Bereiche autorisieren, wenn sie die Google Workspace-Version Ihres Add-ons zum ersten Mal verwenden.
Kann ich meine Chrome-Erweiterung auf ein Google Workspace-Add-on aktualisieren und Nutzer übertragen?
Nein. Sie können die Nutzer, Installationen und Rezensionen einer Chrome-Erweiterung nicht übertragen. Sie müssen ein neues Google Workspace-Add-on erstellen und Nutzer Ihrer Chrome-Erweiterung zum Google Workspace Marketplace weiterleiten.
Kann ich mehrere Add-ons mit meinem Google Workspace-Add-on bündeln?
Weitere Informationen finden Sie unter App-Integrationen gemeinsam auflisten.