Wenn Sie bereits ein Add-on zur Erweiterung von Gmail oder Kalender entwickelt und veröffentlicht haben, können Sie es in ein Google Workspace-Add-on umwandeln. Auf dieser Seite wird beschrieben, wie Sie Ihren bestehenden Gmail- oder Google 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 neue Funktion in Ihr ursprüngliches Add-on übertragen, um Ihr Google Workspace Marketplace-Eintrag, Ihre Installationen und Nutzer beizubehalten. Durch ein Upgrade können Sie auch neue Google Workspace-Add‑on-Funktionen wie Startseiten nutzen.
Schritt 1: Kopie des Apps Script-Projekts Ihres Add-ons erstellen
Ihr aktualisiertes Add-on verwendet dasselbe Google Cloud-Projekt wie Ihr veröffentlichtes Add-on. Es ist jedoch wichtig, eine Kopie des zugrunde liegenden Apps Script-Projekts zu erstellen und zu verwenden, damit Ihre bestehenden Nutzer nicht beeinträchtigt werden, während Sie die aktualisierte Version testen. 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 Kalender-Videokonferenz-Add-on-Apps Script-Projekt.
- 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 Apps Script-Projekt für Add-ons verknüpft ist.
- Klicken Sie auf Projekt festlegen.
Schritt 2: Google Workspace-Add‑on einbinden
Sie müssen alle Google Workspace-Add‑on-Funktionen, die Sie Ihrem Add‑on hinzufügen möchten, selbst entwerfen und implementieren.
- 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 der drei Hosts erscheinen sollen. Wenn Sie eine Startseite auf mehreren Hosts haben möchten, müssen Sie entscheiden, ob es sich um dieselbe Startseite handeln soll oder ob Sie benutzerdefinierte Startseitenkarten für jeden Host verwenden möchten.
- Erstellen Sie in Ihrem kopierten Apps Script-Projekt für das Add‑on die Startseitenkarten mit
homepageTrigger-Funktionen. Achten Sie darauf, alle unterstützenden Funktionen oder Logik einzubinden, die zum Steuern der neuen Startseitenoberflächen erforderlich sind. Erwägen Sie, kontextbezogene Karten hinzuzufügen, die durch eine Nutzeraktion ausgelöst werden, z. B. durch das Öffnen eines Gmail-Nachrichtenthreads oder eines Kalendertermins.
Aktualisieren Sie alle Zugriffe auf Ereignisobjekte in Ihrem Add-on (in Widget-Callback-Funktionen oder in kontextbezogenen Triggerfunktionen), damit die aktualisierte Ereignisobjektstruktur verwendet wird. Die neue Struktur enthält weiterhin dieselben Felder für Ereignisobjekte, die von Gmail- und Kalender-Add-ons für Videokonferenzen verwendet werden. Die ursprünglichen Felder sind jedoch veraltet und werden schließlich entfernt.
Schritt 3: Add-on-Manifest aktualisieren
Die Art und Weise, wie Konfigurationsinformationen in der Manifeststruktur von Google Workspace-Add-ons gespeichert werden, hat sich im Vergleich zur Struktur von Gmail-Add-ons und Kalender-Videokonferenz-Add-ons erheblich geändert. Wenn Sie Ihr Add-on aktualisieren, müssen Sie die Manifestfelder des Apps Script-Projekts Ihres Add-ons entsprechend den Tabellen unten aktualisieren. Sie müssen alle relevanten untergeordneten Properties auf die neue addOns-Property aktualisieren.
Aktualisieren Sie bei Bedarf auch das Feld oauthScopes im Manifest, damit die Berechtigungen, die für das aktualisierte Add-on erforderlich sind, berücksichtigt werden.
Weitere Informationen zu Google Workspace-Add-on-Manifesten
Gmail-Add-ons
| Feld „Ursprüngliches Manifest“ | Aktion erforderlich |
|---|---|
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 Feld vom Typ gmail.universalActions[].text in ein entsprechendes Feld vom Typ addOns.common.universalActions[].label. |
gmail.useLocalFromApp |
Verschieben nach addOns.common.useLocaleFromApp. |
Add-ons für Videokonferenzen in Google Kalender
| Feld „Ursprüngliches Manifest“ | Aktion erforderlich |
|---|---|
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
Informationen zum Testen Ihres aktualisierten Add-ons vor der Veröffentlichung finden Sie unter Google Workspace-Add-ons testen.
Schritt 5: Überprüfungen Ihres aktualisierten Add‑ons beantragen
Alle Google Workspace-Add-ons, unabhängig davon, ob es sich um ein aktualisiertes oder ein von Grund auf neu entwickeltes Add-on handelt, müssen genehmigt werden, bevor sie im Google Workspace Marketplace aufgeführt 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 Version des Codes, die Sie veröffentlichen möchten. Veröffentlichen Sie nicht mit einem Head-Deployment.
Wenn Sie beim Upgrade Ihres Add-ons neue Bereiche hinzugefügt haben, müssen Sie eine OAuth-Überprüfung beantragen. Wenn Ihr Gmail-Add‑on in der Google Workspace-Add‑on-Version beispielsweise neue Drive- oder Calendar-Bereiche verwendet, müssen Sie diese neuen Bereiche zur Überprüfung einreichen. Die Überprüfung dauert oft einige Tage. Beginnen Sie daher so früh wie möglich damit. Achten Sie darauf, dass Ihr Add-on bestätigt 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. Dieses Feld enthält ein Formular, in dem Sie Informationen zu Ihrem Add-on angeben.
Aktualisieren Sie die Kurzbeschreibung, die ausführliche Beschreibung und die Screenshots Ihres Eintrags, um die neuen Funktionen des Google Workspace-Add‑ons widerzuspiegeln.
Klicken Sie unter Erweiterungen auf die Schaltfläche Auf Google Workspace-Add‑on upgraden. 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, müssen Sie sie auf der Seite Konfiguration im Bereich OAuth 2.0-Bereiche hinzufügen. Die in diesem Abschnitt aufgeführten Bereiche müssen genau mit den Bereichen im Manifest Ihres Add-ons ü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 der Aktualisierung des Google Workspace-Add-ons ein Problem auftritt, wenden Sie sich an uns.
FAQ
Hier finden Sie häufig gestellte Fragen zu Add-on-Upgrades:
Kann ich mein Editor-Add-on upgraden?
Die meisten Editor-Add-ons können in Google Workspace-Add-ons umgewandelt werden. Sie lassen sich jedoch nicht so einfach wie Add-ons für Gmail und Google Kalender auf Google Workspace-Add-ons upgraden.
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 Oberfläche umwandeln und die JavaScript-Verarbeitung auf den Card Service aktualisieren.
Einige Dienste in Ihrem vorhandenen Editor-Add-on sind im Card Service möglicherweise nicht verfügbar. Wenn Ihr Editor-Add-on beispielsweise eine Dateiauswahl enthält, ist über den Card Service für Google Workspace-Add-ons keine entsprechende Funktion verfügbar.
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 anderen Markennamen erstellen. Wir erlauben jedoch keine separaten Gmail- oder Google Kalender-Videokonferenz-Add‑ons unter demselben Markennamen wie Ihr Google Workspace-Add‑on. 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 Cloud Platform-Projekt (GCP) mit einer zugehörigen OAuth-Client-ID verwendet, müssen Ihre Nutzer 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 beim ersten Verwenden der Google Workspace-Version Ihres Add-ons autorisieren.
Kann ich meine Chrome-Erweiterung auf ein Google Workspace-Add‑on upgraden und Nutzer übertragen?
Nein. Nutzer, Installationen und Rezensionen eines Chrome-Erweiterungseintrags können nicht übertragen werden. Sie müssen ein neues Google Workspace-Add-on erstellen und Nutzer Ihrer Chrome-Erweiterung an Google Workspace Marketplace verweisen.
Kann ich mehrere Add‑ons mit meinem Google Workspace-Add‑on bündeln?
Weitere Informationen finden Sie unter App-Integrationen gemeinsam auflisten.