Add-ons installieren und autorisieren

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:

1. Sie werden aufgefordert, ein Konto auszuwählen, in dem das Add-on installiert werden soll.
2. 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.
3. 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.

Hinweis: Wenn das Add-on noch nicht bestätigt wurde, werden in der Hostanwendung möglicherweise zusätzliche Dialogfelder angezeigt, in denen Sie darüber informiert werden und die Sie aufgefordert werden, zu bestätigen, dass Sie fortfahren möchten.

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

Hinweis :In diesem Abschnitt wird die Autorisierung von Konferenzlösungen beschrieben, die Google Kalender mit einem Google Workspace-Add-on hinzugefügt werden.

Wenn Sie derzeit kein webbasiertes Konferenzsystem von Drittanbietern haben, muss Ihr Add-on keine Konferenzlösungen autorisieren. Diese Funktion wurde speziell für Konferenzanbieter entwickelt.

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:

1. Öffnen Sie die Konsole für die Kontosicherheit.
2. Suchen Sie das Add-on, das Sie nicht autorisieren möchten, und klicken Sie darauf.
3. 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