Wenn Sie bereits ein Add-on zur Erweiterung von Gmail oder Google 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 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 neue Funktion in Ihr ursprüngliches Add-on übertragen, um Ihren Google Workspace Marketplace-Eintrag, Ihre Installationen und Ihre Nutzer beizubehalten. Durch das Upgrade können Sie auch die neuen Google Workspace-Add-on-Funktionen wie die Startseiten nutzen.
Schritt 1: Kopie des Apps Script-Projekts des Add-ons erstellen
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 beim Testen der aktualisierten Version keine Auswirkungen auf Ihre vorhandenen Nutzer haben. Wenn Sie eine Kopie des ursprünglichen Skriptprojekts upgraden, haben Sie auch immer die Möglichkeit, auf den ursprünglichen Code zuzugreifen und ihn bei Bedarf später noch einmal bereitzustellen.
- Öffnen Sie Ihr bestehendes Apps Script-Projekt für das Gmail-Add-on oder Google Kalender-Konferenz-Add-on.
- 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 Apps Script-Add-on-Projekt zugeordnet ist.
- Klicken Sie auf Projekt festlegen.
Schritt 2: Google Workspace-Add-on einbinden
Sie müssen alle Google Workspace-Add-on-Features entwerfen und implementieren, die Sie dem Add-on hinzufügen möchten.
- Planen Sie, welche Inhalte auf den Karten auf der Startseite Ihres 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 in mehr als einem Host möchten, entscheiden Sie, ob sie dieselbe Startseite sein kann oder ob Sie benutzerdefinierte Startseitenkarten für jeden Host verwenden möchten.
- Erstellen Sie im kopierten Add-on-Apps Script-Projekt Ihre Startseitenkarten mit
homepageTrigger-Funktionen. Binden Sie alle unterstützenden Funktionen oder Logik ein, die zur Steuerung Ihrer 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 jeden Zugriff auf Ereignisobjekte in Ihrem Add-on (in Widget-Callback-Funktionen oder kontextbezogenen Triggerfunktionen), um die aktualisierte Ereignisobjektstruktur zu verwenden. Die neue Struktur enthält weiterhin dieselben Felder für Terminobjekte, die in den Add-ons für Gmail- und Google Kalender-Konferenzen verwendet werden. Die ursprünglichen Felder wurden jedoch eingestellt 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 im Vergleich zur Struktur von Gmail-Add-ons und Google Kalender-Konferenz-Add-ons erheblich geändert. Beim Upgrade des Add-ons müssen Sie die Manifestfelder des Apps Script-Projekts des Add-ons gemäß den folgenden Tabellen aktualisieren. Sie müssen alle relevanten untergeordneten Properties auf die neue Property addOns aktualisieren.
Aktualisieren Sie auch das Feld oauthScopes Ihres Manifests nach Bedarf, um die Berechtigungen zu berücksichtigen, die das aktualisierte Add-on benötigt.
Weitere Informationen zu Manifesten für Google Workspace-Add-ons finden Sie unter Manifeste.
Gmail-Add-ons
| Ursprüngliches Manifestfeld | Wichtige Informationen |
|---|---|
gmail.composeTrigger |
In addOns.gmail.composeTrigger verschieben. |
gmail.contextualTriggers[] |
Verschieben Sie die Liste nach addOns.gmail.contextualTriggers[]. |
gmail.logoUrl |
In addOns.common.logoUrl verschieben. |
gmail.name |
In addOns.common.name verschieben. |
gmail.openLinkUrlPrefixes[] |
Verschieben Sie die Liste nach addOns.common.openLinkUrlPrefixes[].
|
gmail.primaryColor |
In addOns.common.layoutProperties.primaryColor verschieben. |
gmail.secondaryColor |
In addOns.common.layoutProperties.secondaryColor verschieben.
|
gmail.universalActions[] |
Verschieben Sie die Liste nach addOns.common.universalActions[]. |
gmail.universalActions[].text |
Verschieben Sie jedes gmail.universalActions[].text-Feld in ein entsprechendes addOns.common.universalActions[].label-Feld. |
gmail.useLocalFromApp |
In addOns.common.useLocaleFromApp verschieben. |
Add-ons für Kalenderkonferenzen
| Ursprüngliches Manifestfeld | Wichtige Informationen |
|---|---|
calendar.createSettingsUrlFunction |
In addOns.calendar.createSettingsUrlFunction verschieben. |
calendar.conferenceSolution[] |
In addOns.calendar.conferenceSolution[] verschieben. |
calendar.logoUrl |
In addOns.common.logoUrl verschieben. |
calendar.name |
In addOns.common.name verschieben. |
Schritt 4: Aktualisiertes Add-on testen
Informationen zum Testen des aktualisierten Add-ons vor der Veröffentlichung finden Sie unter Google Workspace-Add-ons testen.
Schritt 5: Überprüfung des aktualisierten Add-ons beantragen
Alle Google Workspace-Add-ons, ob aktualisierte oder von Grund auf neu erstellte Add-ons, 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:
Das Add-on muss alle Veröffentlichungsanforderungen für Add-ons erfüllen.
Erstellen Sie eine versionierte Bereitstellung Ihres Google Workspace-Add-ons (im neuen Apps Script-Projekt) mit der Version des Codes, den Sie veröffentlichen möchten. Versuchen Sie nicht, die Veröffentlichung mit einer Head-Bereitstellung zu starten.
Wenn Sie beim Upgrade des Add-ons neue Bereiche hinzugefügt haben, müssen Sie die OAuth-Überprüfung anfordern. Wenn das Gmail-Add-on beispielsweise in der Version des Google Workspace-Add-ons neue Drive- oder Kalender-Bereiche verwendet, müssen Sie diese neuen Bereiche zur Überprüfung einreichen. Die Überprüfung dauert häufig einige Tage. Beginnen Sie den Vorgang also so früh wie möglich. 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. Dieser Bereich enthält ein Formular, in dem Sie Informationen zu Ihrem Add-on angeben.
Aktualisieren Sie die kurze Beschreibung, die detaillierte Beschreibung und die Screenshots Ihres Eintrags, um die neuen Funktionen des Google Workspace-Add-ons zu berücksichtigen.
Klicken Sie unter Erweiterungen auf die Schaltfläche Upgrade auf Google Workspace-Add-on. Geben Sie im angezeigten Textfeld die neue Bereitstellungs-ID ein, die Sie im vorherigen Schritt für das Google Workspace-Add-on erstellt haben. Wenn die Bereitstellungs-ID gültig ist, wird eine Liste der unterstützten Hosts angezeigt.
Wenn Sie dem Google Workspace-Add-on neue Bereiche hinzugefügt haben, müssen Sie sie auf der Seite Konfiguration im Abschnitt 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 im Formular eingegebenen Informationen korrekt sind. Klicken Sie dann auf Änderungen speichern.
Wenn Sie Fragen haben oder beim Upgrade des Google Workspace-Add-ons Probleme auftreten, kontaktieren Sie uns.
FAQs
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. Sie können jedoch nicht so einfach auf Google Workspace-Add-ons aktualisiert werden wie Add-ons für Gmail und Kalender.
Wenn du das 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 im Kartendienst möglicherweise nicht verfügbar. Wenn Ihr Editor-Add-on beispielsweise eine Dateiauswahl enthält, ist kein Äquivalent vom Card Service for Google Workspace-Add-ons verfügbar.
Kann ich ein separates Google Workspace-Add-on erstellen und mein vorhandenes Add-on beibehalten?
Sie können weitere Google Workspace-Add-ons unter verschiedenen Markennamen erstellen. Allerdings sind separate Gmail- oder Kalender-Konferenz-Add-ons unter demselben Markennamen wie Ihr Google Workspace-Add-on nicht zulässig. Wenn du Fragen hast oder eine Ausnahme beantragen möchtest, wende dich 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 verknüpften OAuth-Client-ID verwendet, müssen Ihre Nutzer die Berechtigungen, die sie zuvor für das ursprüngliche Add-on autorisiert hatten, 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 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 mit meinem Google Workspace-Add-on mehrere Add-ons bündeln?
Weitere Informationen finden Sie unter App-Integrationen zusammen auflisten.