Trigger für Google Workspace-Add-ons

Apps Script-Trigger lösen ein bestimmtes Skript aus (die Trigger-Funktion), die ausgeführt werden soll, wenn ein bestimmtes Ereignis erfolgt. Nur bestimmte Ereignisse können zum Auslösen von Triggern führen. Die Google Workspace App unterstützt andere Termine.

Wenn ein Trigger ausgelöst wird, wird ein Ereignisobjekt erstellt. Diese JSON-Struktur enthält Details zu dem aufgetretenen Ereignis. Informationen zum Ereignis ist je nach Triggertyp unterschiedlich organisiert.

Sobald das Ereignisobjekt erstellt wurde, übergibt Apps Script es als Parameter an den auslösen. Die Trigger-Funktion ist eine Callback-Funktion, die Sie die entsprechenden Maßnahmen zu ergreifen, . Beispiel: In einer Google Workspace-Add-on, das Gmail erweitert, können Sie Definieren Sie einen Trigger, der eine neue Kartenoberfläche erstellt, wenn der Nutzer eine Nachricht öffnet. Diskussions-Thread. In diesem Fall implementieren Sie eine kontextbezogene Callback-Funktion, um die Karten, die die neue Benutzeroberfläche aus den Ereignisobjekt.

Diese Seite enthält Richtlinien zur Verwendung von Triggern in Google Workspace Add-on-Projekte erstellt haben.

Manifesttrigger

Im Gegensatz zu Editor-Add-ons, können derzeit keine einfachen Trigger in Apps Script verwenden Stattdessen werden Trigger verwendet, die speziell für Google Workspace-Add-ons: Manifest-Trigger.

Manifesttrigger sind vollständig in der Google Workspace-Add-ons Manifest herunter. Beispiele für Manifest-Trigger sind: Folgendes:

  • Startseiten-Trigger, mit denen die Add-on-Startseite erstellt und angezeigt wird.
  • Kalender-eventOpen-Trigger, die eine neue Karte anzeigen oder eine Aktionen beim Öffnen eines Kalendertermins.
  • Auslöser für Kalender-Ereignis-Updates, die eine neue Karte anzeigen oder eine andere Aktionen, wenn ein Nutzer einen Kalendertermin bearbeitet und speichert.
  • Drive-Trigger für onItemsSelected, die eine neue Karte anzeigen oder andere Aktionen, wenn ein Nutzer eine oder mehrere Dateien oder Ordner in Google Drive auswählt.
  • Trigger für Gmail-Nachrichten, bei denen eine Add-on-Karte angezeigt wird, Nutzer öffnet das Add-on im Gmail-Fenster „Neue Nachricht“.
  • Kontext-Trigger in Gmail, die eine neue Karte anzeigen oder andere Aktionen, wenn der Nutzer eine Gmail-Nachricht öffnet
  • Editor-Trigger für „onFileScopeGranted“, die eine neue Karte anzeigen, wenn Nutzer Autorisierung für den OAuth-Bereich drive.file im aktuellen Editor erteilen Dokument.

In der Liste oben sind nur Startseiten-Trigger nicht kontextbezogen. der Rest sind kontextbezogene Trigger. Siehe Manifest finden Sie weitere Informationen zu Manifest-Triggerdefinitionen.

Neben Manifest-Triggern gibt Google Workspace können auch Apps Script installierbare Trigger.

Einschränkungen

Die Verwendung von Manifest-Triggern unterliegt bestimmten Einschränkungen.

  • Diese Trigger werden nur in Google Workspace-Add-on-Projekten verwendet. sie haben keinen Zweck in einer anderen Anwendung.
  • Da sie im Add-on-Manifest und nicht im Code definiert sind, können Sie Apps Script verwenden Script zum Erstellen oder Ändern dieser Trigger.
  • Kontextbezogene Gmail-Trigger können derzeit nur das Kriterium unconditional haben. Kontextuelle Trigger werden also für jede E-Mail-Nachricht ausgelöst, Inhalte.
  • Jedes Add-on kann nur einen Trigger pro Typ, Nutzer und Dokument haben.