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 Dokumentationsabschnitt wird beschrieben, wie Nutzer Add-ons nutzen.

Add-ons installieren

Bevor Sie ein Add-on verwenden können, müssen Sie es installieren. Nach der Installation ist das Add-on im Google Workspace Hostanwendung erweitert wird.

Sie können veröffentlichte Add-ons über die Google Workspace-Hostanwendung oder über den Google Workspace Marketplace installieren. Domainadministratoren können auch Add-ons für ihre Nutzer aus dem Google Workspace Marketplace. 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

Nachdem Sie ein Add-on installiert haben, ist es im Google Workspace Hostanwendung erweitert wird. Wenn ein Nutzer das Add-on zum ersten Mal verwendet, 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.

Für Editor-Add-ons wird ein Autorisierungsmodell verwendet, Google Workspace-Add-ons. Da Editor-Add-ons für Google Drive-Dateien ausgeführt werden, Das Editor-Autorisierungsmodell definiert verschiedene Autorisierungsmodi, die sich ergeben, wenn Add-ons werden für einzelne Dateien verwendet. Bei der Entwicklung Editor-Add-ons kennen, ist es wichtig, die verschiedenen Modi und wie ein Add-on zwischen ihnen verschoben 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. Daraufhin wird die Liste der Autorisierungen angezeigt, die das Add-on autorisiert hat. ausgeführt werden muss, damit Sie wissen, was zu tun ist. Rezension schreiben Wenn Sie dennoch eine Autorisierung erteilen möchten, Klicken Sie auf Zulassen. Dadurch wird das Add-on aktiviert.
  3. 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

Add-on-Autorisierungskarte

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 wird der Autorisierungsablauf wird gestartet, wenn Sie zum ersten Mal versuchen, das Add-on zu 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 eine Autorisierung erforderlich ist. Google Workspace-Add-ons, die mit solchen Diensten verbunden sind zwei separate Aktionen des Nutzers erfordern:

  • Autorisierung des Add-ons bei der Installation oder beim ersten begonnen.
  • Autorisierung des Nicht-Google-Dienstes 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 Verbinden Sie Ihr Google Workspace-Add-on mit einem Drittanbieterdienst.

Konferenzsysteme von Drittanbietern

Google Workspace-Add-ons, die Google Kalender erweitern können auch weitere konferenzlösungen Nutzer können beim Bearbeiten ein Konferenzsystem eines Drittanbieters auswählen. Google Kalender-Termine Wenn Ihr Add-on Konferenzoptionen bietet, müssen sich Nutzer anmelden, müssen sie mit dem Add-on um dies zu tun.

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.

Nach Erhalt dieses Objekts erstellt Google Kalender in Google Kalender eine Schaltfläche ANMELDEN, Die Benutzeroberfläche zum Bearbeiten von Ereignissen, die auf die vom Add-on bereitgestellte Authentifizierungs-URL verweist 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

Sie sollten Editor-Add-ons testen. wenn Sie sie entwickeln. Der Autorisierungsablauf ist identisch mit für veröffentlichte Editor-Add-ons, mit Ausnahme des Ablaufs wird gestartet, wenn Sie zum ersten Mal versuchen, das Add-on zu 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 hilfreich sein, die Autorisierung der Add-ons aufzuheben, damit Sie sie noch einmal testen können. Autorisierungsprozess durchlaufen.

So widerrufen Sie die Autorisierung eines Add-ons:

  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 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.