Wenn Sie bereits ein Add-on zum Erweitern von Gmail oder Google Kalender erstellt und veröffentlicht haben, können Sie es zu einem Google Workspace-Add-on upgraden. In der Anleitung auf dieser Seite wird beschrieben, wie Sie Ihren vorhandenen Gmail- oder Kalender-Add-ons Google Workspace-Funktionen hinzufügen und das aktualisierte Add-on dann veröffentlichen, damit es gefunden und installiert werden kann.
Sie können die neuen Funktionen in Ihr ursprüngliches Add-on übertragen, um Ihren Eintrag, Ihre Installationen und Ihre Nutzer im Google Workspace Marketplace beizubehalten. Außerdem können Sie dann neue Google Workspace-Add-on-Funktionen wie Startseiten nutzen.
Schritt 1: Eine Kopie des Apps Script-Projekts Ihres Add-ons erstellen
Für das aktualisierte Add-on wird dasselbe Google Cloud-Projekt wie für das veröffentlichte Add-on verwendet. Es ist jedoch wichtig, eine Kopie des zugrunde liegenden Apps Script-Projekts zu erstellen und zu verwenden, damit Ihre bestehenden Nutzer nicht betroffen sind, während Sie die aktualisierte Version testen. Wenn Sie eine Kopie des ursprünglichen Script-Projekts aktualisieren, können Sie auch jederzeit auf den ursprünglichen Code zugreifen und ihn bei Bedarf neu bereitstellen.
- Öffnen Sie Ihr vorhandenes Apps Script-Projekt für das Gmail-Add-on oder das Kalender-Add-on für Videokonferenzen.
- 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 mit Ihrem vorhandenen, veröffentlichten Add-on-Apps Script-Projekt verknüpft ist.
- Klicken Sie auf Projekt festlegen.
Schritt 2: Google Workspace-Add-on einbinden
Sie müssen alle Google Workspace-Add-on-Funktionen entwerfen und implementieren, die Sie Ihrem Add-on hinzufügen möchten.
- Planen Sie, welche Inhalte auf den Startseitenkarten Ihres Add-ons angezeigt werden sollen und ob sie in Gmail, Google Kalender, Google Drive oder einer Kombination aus diesen drei Diensten erscheinen sollen. Wenn Sie eine Startseite auf mehr als einem Host haben möchten, entscheiden Sie, ob es dieselbe Startseite sein kann oder ob Sie benutzerdefinierte Startseitenkarten für jeden Host benötigen.
- Erstellen Sie in Ihrem kopierten Add-on-Apps Script-Projekt Ihre Startseitenkarten mit
homepageTrigger-Funktionen. Fügen Sie alle unterstützenden Funktionen oder Logik hinzu, die zur Steuerung der neuen Startseitenoberflächen erforderlich sind. Sie können kontextbezogene Karten hinzufügen, die durch die Aktion eines Nutzers ausgelöst werden, z. B. das Öffnen eines Gmail-Nachrichtenthreads oder eines Kalendertermins.
Aktualisieren Sie alle Zugriffe auf Ereignisobjekte in Ihrem Add-on (in Widget-Callback-Funktionen oder in Funktionen für kontextbezogene Trigger), um die aktualisierte Ereignisobjektstruktur zu verwenden. Die neue Struktur enthält weiterhin dieselben Felder für Ereignisobjekte, die von den Konferenz-Add-ons von Gmail und Google Kalender verwendet werden. Diese ursprünglichen Felder werden jedoch eingestellt und nach und nach 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 erheblich von der Struktur geändert, die für Gmail-Add-ons und Kalender-Add-ons für Videokonferenzen verwendet wird. Wenn Sie Ihr Add-on aktualisieren, müssen Sie die Manifestfelder des Apps Script-Projekts Ihres Add-ons 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 widerzuspiegeln, die für das aktualisierte Add-on erforderlich sind.
Weitere Informationen zu Manifesten für Google Workspace-Add-ons finden Sie unter Manifeste.
Gmail-Add-ons
| Feld „Original Manifest“ | Aktion erforderlich |
|---|---|
gmail.composeTrigger |
Verschieben Sie sich zu addOns.gmail.composeTrigger. |
gmail.contextualTriggers[] |
Verschieben Sie die Liste zu addOns.gmail.contextualTriggers[]. |
gmail.logoUrl |
Verschieben Sie sich zu addOns.common.logoUrl. |
gmail.name |
Verschieben Sie sich zu addOns.common.name. |
gmail.openLinkUrlPrefixes[] |
Verschieben Sie die Liste zu addOns.common.openLinkUrlPrefixes[].
|
gmail.primaryColor |
Verschieben Sie sich zu addOns.common.layoutProperties.primaryColor. |
gmail.secondaryColor |
Verschieben Sie sich zu addOns.common.layoutProperties.secondaryColor.
|
gmail.universalActions[] |
Verschieben Sie die Liste zu addOns.common.universalActions[]. |
gmail.universalActions[].text |
Verschieben Sie jedes gmail.universalActions[].text-Feld in ein entsprechendes addOns.common.universalActions[].label-Feld. |
gmail.useLocalFromApp |
Verschieben Sie sich zu addOns.common.useLocaleFromApp. |
Add-ons für Videokonferenzen in Google Kalender
| Feld „Original Manifest“ | Aktion erforderlich |
|---|---|
calendar.createSettingsUrlFunction |
Verschieben Sie sich zu addOns.calendar.createSettingsUrlFunction. |
calendar.conferenceSolution[] |
Verschieben Sie sich zu addOns.calendar.conferenceSolution[]. |
calendar.logoUrl |
Verschieben Sie sich zu addOns.common.logoUrl. |
calendar.name |
Verschieben Sie sich zu addOns.common.name. |
Schritt 4: Upgraded-Add-on testen
Wie Sie das aktualisierte Add-on vor der Veröffentlichung testen, erfahren Sie unter Google Workspace-Add-ons testen.
Schritt 5: Rezensionen für das aktualisierte Add-on anfordern
Alle Google Workspace-Add-ons, unabhängig davon, ob es sich um ein Upgrade-Add-on oder ein neu erstelltes Add-on handelt, müssen genehmigt werden, bevor sie im Google Workspace Marketplace gelistet werden können.
So reichen Sie Ihr Add-on zur Überprüfung ein:
Ihr Add-on muss alle Anforderungen für die Veröffentlichung von Add-ons erfüllen.
Erstellen Sie eine versionierte Bereitstellung Ihres Google Workspace-Add-ons (im neuen Apps Script-Projekt) mit der Codeversion, die Sie veröffentlichen möchten. Versuchen Sie nicht, eine Bereitstellung mit einer Head-Version zu veröffentlichen.
Wenn Sie beim Aktualisieren Ihres Add-ons neue Bereiche hinzugefügt haben, müssen Sie die OAuth-Überprüfung beantragen. Wenn Ihr Gmail-Add-on beispielsweise neue Drive- oder Kalenderbereiche in der Google Workspace-Add-on-Version verwendet, müssen Sie diese neuen Bereiche zur Bestätigung einreichen. Die Überprüfung dauert oft einige Tage. Beginnen Sie daher so früh wie möglich damit. Prüfen Sie, ob Ihr Add-on bestätigt wurde, bevor Sie mit Schritt 6 fortfahren.
Schritt 6: Upgrade-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 Kurz- und Detailbeschreibung sowie die Screenshots Ihres Eintrags, damit sie die neuen Funktionen des Google Workspace-Add-ons widerspiegeln.
Klicken Sie unter Erweiterungen auf die Schaltfläche Auf Google Workspace-Add-on umstellen. Geben Sie in das angezeigte Textfeld die neue Bereitstellungs-ID ein, die Sie im vorherigen Schritt für Ihr 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, fügen Sie sie auf der Seite Konfiguration im Abschnitt OAuth 2.0-Bereiche hinzu. Die in diesem Abschnitt aufgeführten Berechtigungen müssen genau mit den Berechtigungen im Manifest Ihres Add-ons übereinstimmen.
Prüfen Sie, ob die Informationen, die Sie im Formular eingegeben haben, korrekt sind. Klicken Sie dann auf Änderungen speichern.
Wenn Sie Fragen haben oder während des Upgrades eines Google Workspace-Add-ons auf ein Problem stoßen, wenden Sie sich bitte an uns.
FAQ
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 zu Google Workspace-Add-ons migriert werden. Sie können jedoch nicht so einfach wie Add-ons für Gmail und Google Kalender auf Google Workspace-Add-ons umgestellt werden.
Wenn Sie Ihr Editor-Add-on zu einem Google Workspace-Add-on migrieren möchten, müssen Sie die Benutzeroberfläche des Add-ons von HTML in eine kartenbasierte Benutzeroberfläche umschreiben und die JavaScript-Verarbeitung auf den Kartendienst aktualisieren.
Einige Dienste in Ihrem vorhandenen Editor-Add-on sind möglicherweise nicht im Kartendienst verfügbar. Wenn Ihr Editor-Add-on beispielsweise eine Dateiauswahl enthält, gibt es im Kartendienst für Google Workspace-Add-ons kein entsprechendes Äquivalent.
Kann ich ein separates Google Workspace-Add-on erstellen und mein vorhandenes Add-on behalten?
Sie können zusätzliche Google Workspace-Add-ons unter verschiedenen Markennamen erstellen. Wir erlauben jedoch keine separaten Gmail- oder Kalender-Konferenz-Add-ons unter demselben Markennamen wie Ihr Google Workspace-Add-on. Wenn Sie Fragen haben oder eine Ausnahme beantragen möchten, wenden Sie sich bitte 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 (Google Cloud Platform) mit einer verknüpften OAuth-Client-ID verwendet, müssen Ihre Nutzer die Berechtigungen, die sie zuvor für Ihr ursprüngliches Add-on autorisiert haben, nicht noch einmal autorisieren. Wenn Sie jedoch während des Upgrades 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 zu einem Google Workspace-Add-on upgraden 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.