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, um bestehende Gmail- oder Kalender-Add-ons um Google Workspace-Funktionen zu ergänzen und veröffentlichen Sie dann das aktualisierte Add-on, damit es gefunden und installiert werden kann.
Sie können die neuen Funktionen in Ihre , um Ihren Eintrag, Ihre Installationen und Ihre Nutzer im Google Workspace Marketplace beizubehalten. Durch das Upgrade können Sie auch die neuen Funktionen des Google Workspace-Add-ons nutzen wie zum Beispiel Startseiten.
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 der zugrunde liegenden Apps zu erstellen und zu verwenden. Erstellen Sie ein Script für das Projekt, damit Ihre vorhandenen Nutzer während des Tests nicht betroffen sind die aktualisierte Version. Beim Upgrade einer Kopie des ursprünglichen Skriptprojekts Sie können immer auf den ursprünglichen Code zugreifen und ihn später erneut bereitstellen, notwendig ist.
- Vorhandenes Apps Script-Add-on für Gmail oder Google Kalender öffnen Projekt arbeiten.
- Klicken Sie links auf Übersicht.
- Klicken Sie rechts auf „Kopie erstellen“ .
- Klicken Sie links auf Project Settings > Projekt ändern.
- Klicken Sie auf GCP-Projektnummer.
- Gleich eingeben Projektnummer die mit Ihrem bestehenden, veröffentlichten Apps Script-Add-on-Projekt verknüpft sind.
- 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 Team hinzufügen möchten für Ihr Add-on.
- Festlegen, welche Inhalte im Add-on angezeigt werden Infokarten auf der Startseite und ob sie in Gmail, Google Kalender, Google Drive oder einer beliebigen Kombination der drei Hosts. Wenn Sie eine Startseite von mehr als einem Host haben möchten, entscheiden Sie, kann dieselbe Startseite sein oder wenn Sie benutzerdefinierte Startseitenkarten für jeden Host verwenden möchten.
- Startseite im kopierten Add-on-Projekt für Apps Script erstellen
Karten mit
homepageTriggerFunktionen. Stellen Sie sicher, dass Sie alle unterstützenden Funktionen oder Logik angeben, die für Ihre neuen Startseiten-Oberflächen verwalten. Fügen Sie gegebenenfalls Kontextkarten hinzu, die durch eine Nutzeraktion ausgelöst werden, z. B. das Öffnen eines Gmail-Konversation oder Kalendertermin.
Aktualisieren Sie jeden Zugriff auf Ereignisobjekte. im Add-on (in Widget-Callback-Funktionen oder im kontextbezogenen Trigger -Funktionen), um die aktualisierten Ereignisobjektstruktur. Die neue Struktur enthält weiterhin dieselben Ereignisobjektfelder, die von Konferenz-Add-ons für Gmail und Google Kalender. Die ursprünglichen Felder sind jedoch und wird irgendwann entfernt.
Schritt 3: Manifest des Add-ons aktualisieren
Die Art und Weise, wie Konfigurationsinformationen im
Manifeststruktur von
Google Workspace-Add-ons haben sich gegenüber der Gmail-Add-ons-Struktur erheblich verändert
und Google Kalender-Add-ons für Videokonferenzen nutzen. Beim Upgrade des Add-ons müssen Sie die Manifestfelder des Apps Script-Projekts des Add-ons gemäß den
in den Tabellen unten. Sie müssen alle relevanten untergeordneten Properties auf die neue
addOns-Property.
Aktualisieren Sie auch die
oauthScopes als
die für das aktualisierte Add-on erforderlich sind.
Weitere Informationen zu Manifesten des Google Workspace-Add-ons Siehe Manifeste.
Gmail-Add-ons
| Ursprüngliches Manifestfeld | Aktion erforderlich |
|---|---|
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
entsprechende addOns.common.universalActions[].label
ein. |
gmail.useLocalFromApp |
In addOns.common.useLocaleFromApp verschieben. |
Add-ons für Kalenderkonferenzen
| Ursprüngliches Manifestfeld | Aktion erforderlich |
|---|---|
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
So testen Sie das aktualisierte Add-on vor der Veröffentlichung: Weitere Informationen finden Sie im Hilfeartikel Google Workspace-Add-ons testen.
Schritt 5: Überprüfung des aktualisierten Add-ons beantragen
Alle Google Workspace-Add-ons – ob aktualisierte oder komplett neue 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:
Ihr Add-on muss alle Anforderungen für die Veröffentlichung von Add-ons.
Versionierte Bereitstellung erstellen Ihres Google Workspace-Add-ons (im neuen Apps Script-Projekt) mit der Version von den Code, den Sie veröffentlichen möchten. Versuchen Sie nicht, die Veröffentlichung mit dem Bereitstellung.
Wenn Sie beim Upgrade des Add-ons neue Bereiche hinzugefügt haben, OAuth-Überprüfung anfordern Wenn das Gmail-Add-on beispielsweise neue Drive- oder Kalender-Bereiche im Version des Google Workspace-Add-ons müssen Sie diese neuen Bereiche zur Überprüfung einreichen. Die Überprüfung dauert häufig einige Tage. so früh wie möglich. Das Add-on muss bestätigt sein, bevor Sie fortfahren mit Schritt 6.
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 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 für das Google Workspace-Add-on aus dem vorherigen Schritt. 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 dem Abschnitt OAuth 2.0-Bereiche auf der Seite Konfiguration. Die aufgeführten Bereiche in diesem Abschnitt genau mit den Bereichen übereinstimmen, die im Manifests.
Prüfen Sie, ob die im Formular eingegebenen Informationen korrekt sind. Gehen Sie dann so vor: Klicken Sie auf Änderungen speichern.
Bei Fragen oder Problemen während des Upgrades des Google Workspace-Add-ons 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 in Google Workspace-Add-ons verschoben werden. Sie können jedoch nicht auf Google Workspace-Add-ons aktualisiert werden, genauso einfach wie Add-ons für Gmail und Kalender:
Wenn Sie das 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 und aktualisieren Sie den JavaScript-Code, Umgang mit dem Kartendienst.
Einige Dienste im bestehenden Editor-Add-on sind möglicherweise nicht im Kartendienst. Wenn Ihr Editor-Add-on beispielsweise eine Dateiauswahl enthält, ist kein Äquivalent des Kartendienstes für Google Workspace-Add-ons.
Kann ich ein separates Google Workspace-Add-on erstellen und mein vorhandenes Add-on beibehalten?
Gern können Sie weitere Google Workspace-Add-ons unter verschiedenen Markennamen, Allerdings erlauben wir keine separaten Konferenz-Add-ons für Gmail oder Google Kalender unter der denselben Markennamen wie Ihr Google Workspace-Add-on verwenden. Wenn Sie Fragen haben oder eine 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 dieselbe zugrunde liegende Cloud Platform-Projekt (GCP) mit einer verknüpften OAuth-Client-ID, müssen sich deine Nutzer nicht noch einmal autorisieren. Berechtigungen, die sie zuvor für das ursprüngliche Add-on autorisiert haben. Wenn jedoch Wenn Sie während des Upgrades neue Bereiche hinzufügen, müssen Ihre Nutzer diese neue Bereiche hinzugefügt werden, wenn sie Google Workspace Version Ihres Add-ons.
Kann ich meine Chrome-Erweiterung auf ein Google Workspace-Add-on aktualisieren und Nutzer übertragen?
Nein. Sie können die Nutzer, Installationen und Einträge einer Chrome-Erweiterung nicht übertragen. Rezensionen. Sie müssen ein neues Google Workspace-Add-on erstellen und Nutzer Ihres Chrome-Browsers anweisen für den Google Workspace Marketplace.
Kann ich mit meinem Google Workspace-Add-on mehrere Add-ons bündeln?
Weitere Informationen finden Sie unter App-Integrationen zusammen auflisten.