Diese Seite wurde von der Cloud Translation API übersetzt.

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-Nutzung sind, sollten Sie sie kennen, bevor Sie eigene 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 von ihm erweiterten Google Workspace-Hostanwendung verfügbar.

Sie können veröffentlichte Add-ons über die Google Workspace-Hostanwendung oder über den Google Workspace Marketplace installieren. Domainadministratoren können Add-ons auch im Namen ihrer Nutzer aus dem Google Workspace Marketplace installieren. Sie können auch nicht veröffentlichte Add-ons installieren, die Sie gerade entwickeln, 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

Nach der Installation ist das Add-on in der erweiterten Google Workspace-Hostanwendung verfügbar. Wenn ein Nutzer zum ersten Mal versucht, das Add-on zu verwenden, wird ihm in der Hostanwendung eine Autorisierungskarte oder ein Autorisierungsdialogfeld angezeigt. Auf dieser Karte wird erläutert, für welche Aktionen des Nutzers das Add-on eine Berechtigung benötigt, z. B. für den Zugriff auf den Inhalt der aktuellen Google-Tabelle. Der Nutzer kann diese Berechtigungen dann gewähren und das Add-on ausführen lassen. Wenn der Nutzer die Autorisierung für das Add-on ablehnt, kann er es nicht verwenden.

Editor-Add-ons verwenden ein Autorisierungsmodell, das sich von dem von Google Workspace-Add-ons unterscheidet. Da Editor-Add-ons auf Google Drive-Dateien angewendet werden, definiert das Autorisierungsmodell für den Editor verschiedene Autorisierungsmodi, die sich aus der Verwendung von Add-ons mit einzelnen Dateien ergeben. Wenn Sie Editor-Add-ons entwickeln, ist es wichtig, die verschiedenen Modi zu kennen und zu verstehen, wie ein Add-on zwischen ihnen wechselt.

Veröffentlichte Add-ons autorisieren

Nachdem Sie ein veröffentlichtes Add-on installiert haben, beginnt sofort der Autorisierungsvorgang:

Sie werden aufgefordert, ein Konto auszuwählen, in dem das Add-on installiert werden soll.
Daraufhin wird eine Liste der Autorisierungen angezeigt, die für die Funktion des Add-ons erforderlich sind. So können Sie nachvollziehen, was das Add-on versucht. Prüfen Sie diese Liste sorgfältig und klicken Sie auf Zulassen, wenn Sie die Autorisierung erteilen möchten. Dadurch wird das Add-on aktiviert.
Sie können es jetzt über die Hostanwendung ausführen, die es erweitert. Wenn die Anwendung bereits in einem Browsertab geöffnet war, müssen Sie den Tab möglicherweise aktualisieren, bevor das Add-on verfügbar wird.

Wenn das von Ihnen installierte Add-on später aktualisiert wird und zusätzliche Berechtigungen erfordert, die Sie noch nicht erteilt haben, werden Sie bei der nächsten Verwendung des Add-ons aufgefordert, diese Berechtigungen zu erteilen.

Nicht veröffentlichte Google Workspace-Add-ons autorisieren

Karte für Add-on-Autorisierung

Für nicht veröffentlichte Add-ons gilt nicht derselbe Autorisierungsablauf wie für veröffentlichte Add-ons, da sie noch nicht im Google Workspace Marketplace aufgeführt sind. Nach der Installation eines nicht veröffentlichten Add-ons werden Sie nicht sofort zur Autorisierung aufgefordert. Stattdessen beginnt der Autorisierungsvorgang, wenn Sie das Add-on zum ersten Mal verwenden.

Wenn ein Add-on ausgeführt wird, wird ermittelt, ob eine Nutzerautorisierung erforderlich ist. Wenn eine Autorisierung erforderlich ist, wird im Add-on eine Autorisierungskarte angezeigt. Eine Autorisierung ist immer erforderlich, wenn ein Add-on zum ersten Mal ausgeführt wird. Sie 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 der Nutzer die Autorisierung für das Add-on zulassen oder ablehnen kann.

Drittanbieterdienste für ein Google Workspace-Add-on autorisieren

Es ist möglich, dass ein Google Workspace-Add-on eine Verbindung zu einem Drittanbieterdienst herstellt, für den selbst eine Autorisierung erforderlich ist. Für Google Workspace-Add-ons, die eine Verbindung zu solchen Diensten herstellen, sind zwei separate Aktionen des Nutzers erforderlich:

Autorisierung des Add-ons selbst, wenn es installiert oder zum ersten Mal gestartet wird.
Autorisierung des Drittanbieterdienstes beim ersten Zugriff

Wenn ein von Ihnen entwickeltes Google Workspace-Add-on über OAuth auf einen Drittanbieterdienst zugreifen muss, müssen Sie die Verbindung für diesen Dienst beim Erstellen des Add-ons 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 Videokonferenzlösungen hinzugefügt werden, mit denen Nutzer beim Bearbeiten von Google Kalender-Terminen ein Konferenzsystem von Drittanbietern auswählen können. Wenn Ihr Add-on Konferenzoptionen bietet, für die sich Nutzer anmelden müssen, muss Ihr Add-on Nutzern die Möglichkeit dazu bieten.

Wenn ein Nutzer versucht, eine Konferenz mit Ihrem Add-on zu erstellen, ohne sich anzumelden, sollte die onCreateFunction-Methode der Konferenzlösung ein ConferenceData-Objekt mit einem ConferenceError mit einer Authentifizierungs-URL zurückgeben.

Wenn Google Kalender dieses Objekt empfängt, wird in der Bedienoberfläche zum Bearbeiten des Termins die Schaltfläche ANMELDEN erstellt, die mit der Authentifizierungs-URL des Add-ons verknüpft ist. Nutzer können sich dann über diese Schaltfläche im System des Drittanbieters anmelden, bevor sie das Add-on weiter verwenden.

Weitere Informationen zur Autorisierung mit ConferenceError finden Sie unter Drittanbieterkonferenzen erstellen.

Nicht veröffentlichte Editor-Add-ons autorisieren

Es empfiehlt sich, Editor-Add-ons während der Entwicklung zu testen. Der Autorisierungsvorgang entspricht dem für veröffentlichte Editor-Add-ons, mit der Ausnahme, dass er gestartet wird, wenn Sie das Add-on zum ersten Mal testen. Wenn Sie dasselbe Add-on später noch einmal testen, werden Sie nicht noch einmal zur Autorisierung aufgefordert.

Autorisierung von Add-ons widerrufen

Bei der Entwicklung von Add-ons kann es nützlich sein, die Autorisierung aufzuheben, damit Sie den Autorisierungsvorgang noch einmal testen können.

So widerrufen Sie die Autorisierung eines Add-ons:

Öffnen Sie die Konsole für die Kontosicherheit.
Suchen Sie das Add-on, dessen Autorisierung Sie aufheben möchten, und klicken Sie darauf.
Klicken Sie auf Zugriff entfernen.

Wenn Sie das Add-on nach der Aufhebung der Autorisierung noch einmal ausführen, wird der Autorisierungsvorgang noch einmal angezeigt.

Add-ons deinstallieren

Informationen zum Deinstallieren eines Add-ons, das Sie über den Google Workspace Marketplace installiert haben, finden Sie unter Marketplace-App oder ‑Add-on deinstallieren.

Informationen zum Deinstallieren eines nicht veröffentlichten Add-ons, das in Apps Script eingebunden ist, finden Sie unter Nicht veröffentlichtes Add-on deinstallieren.