Add-ons installieren und autorisieren

Nutzer müssen ein Add-on installieren und autorisieren, öffnen und verwenden kann. Da diese Schritte der erste Teil des die User Experience von Add-ons, 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 aus der Google Workspace Marketplace 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 entwickeln, damit Sie sie testen können. Bevor Sie eine installierte Add-on hinzugefügt haben, müssen Sie autorisieren .

Weitere Informationen finden Sie unter Veröffentlichen Sie Add-ons.

Add-ons autorisieren

Nachdem Sie ein Add-on installiert haben, ist es im Google Workspace Hostanwendung erweitert wird. Wenn ein Nutzer zum ersten Mal versucht, dem Add-on der Host-Anwendung eine Autorisierungskarte oder Dialogfeld. Auf dieser Karte wird erläutert, das Add-on die Berechtigung für den Nutzer benötigt, z. B. auf den Inhalt der aktuellen Google-Tabelle zugreifen. Der Nutzer kann diese dann und erlauben Sie dem Add-on, fortzufahren. Wenn die Nutzer lehnt das Add-on ab können keine Add-ons verwendet werden.

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 zur Verwendung aktiviert.
  3. Sie kann sie jetzt über die Hostanwendung erweitert wird. Wenn die Anwendung bereits in einem Browsertab geöffnet war, können Sie müssen Sie den Tab aktualisieren, damit das Add-on verfügbar ist.

Wenn das von Ihnen installierte Add-on später aktualisiert wird und zusätzliche noch nicht erteilte Autorisierungen haben, werden Sie aufgefordert, diese wenn Sie das Add-on das nächste Mal verwenden.

Nicht veröffentlichte Google Workspace-Add-ons autorisieren

Add-on-Autorisierungskarte

Nicht veröffentlichte Add-ons durchlaufen nicht denselben Autorisierungsablauf wie veröffentlichte Add-ons da sie noch nicht im Google Workspace Marketplace aufgeführt sind. Nachher ein unveröffentlichtes Add-on installieren, 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, bestimmt es, ob eine Nutzerautorisierung erforderlich ist. Wenn erforderlich ist, zeigt das Add-on eine Autorisierungskarte an. Die Autorisierung ist bei der ersten Ausführung eines Add-ons immer erforderlich und kann auch ist erforderlich, wenn eine neue Version des Add-ons einen Dienst verwendet, der vorher nicht verwendet wurde. autorisiert wurde. Über die Schaltfläche Zugriff autorisieren wird ein Dialogfeld für die , um die Autorisierung für das Add-on zuzulassen oder zu verweigern.

Nicht von Google stammende Dienste für ein Google Workspace-Add-on autorisieren

Ein Google Workspace-Add-on kann eine Verbindung an einen Drittanbieterdienst, der selbst autorisiert werden muss. Google Workspace-Add-ons, die mit solchen Diensten verknüpft 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 Google Workspace-Add-on, das Sie benötigen, Wenn Sie mit OAuth auf einen Drittanbieterdienst zugreifen möchten, müssen Sie die Verbindung konfigurieren wenn Sie das Add-on erstellen.

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, die onCreateFunction-Methode der Konferenzlösungen sollte ein ConferenceData Objekt, das ein ConferenceError mit einem Authentifizierungs-URL.

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 mit dieser Schaltfläche im Drittanbietersystem anmelden, bevor sie wenn Sie das Add-on verwenden.

Siehe Konferenzen von Drittanbietern erstellen .ConferenceError

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 den Test später erneut ausführen, nicht mehr zur Autorisierung aufgefordert.

Autorisierung von Add-ons aufheben

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 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 wieder ausführen, noch einmal präsentiert wird.