Nutzer müssen ein Add-on installieren und autorisieren, bevor sie es öffnen und verwenden können. Da diese Schritte der erste Teil der Add-on-Nutzererfahrung sind, sollten Sie sie verstehen, bevor Sie Ihre eigenen Add-ons erstellen.
In diesem Abschnitt der Dokumentation wird beschrieben, wie Nutzer Add-ons installieren, autorisieren und verwenden können.
Add-ons installieren
Bevor Sie ein Add-on verwenden können, müssen Sie es installieren. Nach der Installation ist das Add-on in der erweiterten Google Workspace-Hostanwendung verfügbar.
Sie können veröffentlichte Add-ons über die Google Workspace-Hostanwendung oder den Google Workspace Marketplace installieren. Domainadministratoren können auch Add-ons im Namen ihrer Nutzer aus dem Google Workspace Marketplace installieren. Sie können auch von Ihnen entwickelte unveröffentlichte Add-ons installieren, um sie zu testen. Bevor Sie ein installiertes Add-on zum ersten Mal verwenden können, müssen Sie es autorisieren.
Weitere Informationen finden Sie unter Add-ons veröffentlichen.
Add-ons autorisieren
Nachdem Sie ein Add-on installiert haben, ist es in der erweiterten Google Workspace-Hostanwendung verfügbar. Wenn ein Nutzer zum ersten Mal versucht, das Add-on zu verwenden, wird ihm von der Hostanwendung eine Autorisierungskarte oder ein Dialogfeld angezeigt. Auf dieser Karte wird erläutert, welche Berechtigungen das Add-on für den Nutzer benötigt, z. B. Zugriff auf den Inhalt der aktuellen Google-Tabelle. Der Nutzer kann diese Berechtigungen dann gewähren und das Add-on weiter ausführen. Wenn der Nutzer die Autorisierung des Add-ons ablehnt, kann er das Add-on nicht verwenden.
Für Editor-Add-ons wird ein Autorisierungsmodell verwendet, das sich von Google Workspace-Add-ons unterscheidet. Da Editor-Add-ons für Google Drive-Dateien ausgeführt werden, definiert das Editor-Autorisierungsmodell verschiedene Autorisierungsmodi, die sich ergeben, wenn Add-ons mit einzelnen Dateien verwendet werden. Bei der Entwicklung von Editor-Add-ons ist es wichtig, die verschiedenen Modi zu verstehen und zu verstehen, wie ein Add-on zwischen ihnen bewegt wird.
Veröffentlichte Add-ons autorisieren
Nachdem Sie ein veröffentlichtes Add-on installiert haben, beginnt der Autorisierungsvorgang sofort:
- Sie werden aufgefordert, ein Konto auszuwählen, in dem das Add-on installiert werden soll.
- Sie sehen dann die Liste der Autorisierungen, die das Add-on ausführen muss, damit Sie wissen, was zu tun ist. Prüfen Sie diese Liste sorgfältig. Wenn Sie trotzdem die Autorisierung erteilen möchten, klicken Sie auf Zulassen. Dadurch wird das Add-on zur Verwendung aktiviert.
- Sie kann jetzt über die erweiterte Hostanwendung ausgeführt werden. Wenn die Anwendung bereits in einem Browsertab geöffnet war, müssen Sie den Tab möglicherweise aktualisieren, damit das Add-on verfügbar ist.
Wenn das von Ihnen installierte Add-on später aktualisiert wird und zusätzliche Autorisierungen erfordert, die Sie noch nicht gewährt haben, werden Sie bei der nächsten Verwendung des Add-ons aufgefordert, diese Berechtigungen zu erteilen.
Nicht veröffentlichte Google Workspace-Add-ons autorisieren
Nicht veröffentlichte Add-ons durchlaufen nicht den gleichen Autorisierungsablauf wie veröffentlichte Add-ons, da sie noch nicht im Google Workspace Marketplace aufgeführt sind. Nach der Installation eines unveröffentlichten Add-ons werden Sie nicht sofort zur Autorisierung aufgefordert. Stattdessen beginnt der Autorisierungsvorgang, sobald Sie das Add-on zum ersten Mal verwenden.
Wenn ein Add-on ausgeführt wird, bestimmt es, ob eine Nutzerautorisierung erforderlich ist. Wenn eine Autorisierung erforderlich ist, zeigt das Add-on eine Autorisierungskarte an. Die Autorisierung ist immer erforderlich, wenn ein Add-on zum ersten Mal ausgeführt wird, und kann auch erforderlich sein, wenn eine neue Version des Add-ons einen Dienst verwendet, der zuvor nicht autorisiert wurde. Über die Schaltfläche Zugriff autorisieren wird ein Dialogfeld geöffnet, in dem Nutzer die Autorisierung für das Add-on zulassen oder ablehnen können.
Nicht von Google stammende Dienste für ein Google Workspace-Add-on autorisieren
Ein Google Workspace-Add-on kann mit einem Drittanbieterdienst verbunden werden, der eine Autorisierung erfordert. Google Workspace-Add-ons, die mit solchen Diensten verbunden sind, erfordern zwei separate Aktionen vom Nutzer:
- Autorisierung des Add-ons selbst bei der Installation oder beim ersten Start des Add-ons.
- Autorisierung des Nicht-Google-Dienstes beim ersten Zugriff.
Wenn ein von Ihnen entwickeltes Google Workspace-Add-on mit OAuth auf einen Drittanbieterdienst zugreifen muss, müssen Sie beim Erstellen des Add-ons die Verbindung für diesen Dienst konfigurieren.
Weitere Informationen finden Sie unter Google Workspace-Add-on mit einem Drittanbieterdienst verbinden.
Konferenzsysteme von Drittanbietern
Mit Google Workspace-Add-ons, die Google Kalender erweitern, können auch zusätzliche Konferenzlösungen hinzugefügt werden, mit denen Nutzer beim Bearbeiten von Google Kalender-Terminen ein Drittanbietersystem auswählen können. Wenn Ihr Add-on Konferenzoptionen bereitstellt, bei denen sich der Nutzer anmelden muss, muss das Add-on dem Nutzer die Möglichkeit dazu geben.
Wenn ein Nutzer versucht, ohne erforderliche Anmeldung eine Konferenz mit Ihrem Add-on zu erstellen, sollte die Methode onCreateFunction
der Konferenzlösungen ein ConferenceData
-Objekt zurückgeben, das eine ConferenceError
mit einer Authentifizierungs-URL enthält.
Nach Erhalt dieses Objekts erstellt Google Kalender in der Benutzeroberfläche zur Terminbearbeitung eine Schaltfläche ANMELDEN, die mit der vom Add-on bereitgestellten Authentifizierungs-URL verknüpft ist. Nutzer können sich dann mit dieser Schaltfläche im Drittanbietersystem anmelden, bevor sie das Add-on weiter verwenden können.
Weitere Informationen zur Autorisierung mit ConferenceError
finden Sie unter Konferenzen von Drittanbietern erstellen.
Nicht veröffentlichte Editor-Add-ons autorisieren
Es empfiehlt sich, Editor-Add-ons während der Entwicklung zu testen. Der Autorisierungsvorgang ist mit dem für veröffentlichte Editor-Add-ons identisch. Der einzige Unterschied besteht darin, dass er mit dem ersten Test des Add-ons beginnt. Wenn Sie dasselbe Add-on später noch einmal testen, werden Sie nicht noch einmal zur Autorisierung aufgefordert.
Autorisierung von Add-ons aufheben
Bei der Entwicklung von Add-ons kann es hilfreich sein, die Autorisierung aufzuheben, damit Sie den Autorisierungsvorgang noch einmal testen können.
So heben Sie die Autorisierung eines Add-ons auf:
- Öffnen Sie die Konsole für die Kontosicherheit.
- Suchen Sie das Add-on, das Sie nicht autorisieren möchten, und klicken Sie darauf.
- Klicken Sie auf Zugriffsrechte entfernen.
Wenn Sie das Add-on nach der Aufhebung der Autorisierung noch einmal ausführen, wird der Autorisierungsvorgang noch einmal angezeigt.
Weitere Informationen
- Installierte Add-ons öffnen und verwenden
- Google Workspace-Add-on mit einem Drittanbieterdienst verbinden