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:
- Sie werden aufgefordert, ein Konto auszuwählen, in dem das Add-on installiert werden soll.
- 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.
- 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
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:
- Ö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 wieder ausführen, noch einmal präsentiert wird.
Add-ons deinstallieren
So deinstallieren Sie ein Add-on, das Sie über die Google Workspace Marketplace, siehe Deinstallieren Sie eine Marketplace-App oder ein Add-on.
So deinstallieren Sie ein nicht veröffentlichtes, integriertes Add-on: Apps Script, siehe Unveröffentlichtes Element deinstallieren Add-on.
Weitere Informationen
- Installierte Add-ons öffnen und verwenden
- Google Workspace-Add-on mit einem Drittanbieterdienst verbinden