Auslöser für Google Workspace-Add-ons

Apps Script-Trigger bewirken, dass eine bestimmte Skript funktion (die Triggerfunktion) ausgeführt wird, wenn ein bestimmtes Ereignis eintritt. Nur bestimmte Ereignisse können Trigger auslösen und jede Google Workspace-Anwendung unterstützt eine andere Reihe von Ereignissen.

Wenn ein Trigger ausgelöst wird, wird ein Ereignisobjekt erstellt. Diese JSON-Struktur enthält Details zum aufgetretenen Ereignis. Die Informationen in der Ereignisobjektstruktur sind je nach Triggertyp unterschiedlich organisiert.

Sobald das Ereignisobjekt erstellt wurde, übergibt Apps Script es als Parameter an die Triggerfunktion. Die Triggerfunktion ist eine Callback-Funktion, die Sie selbst implementieren müssen, um die entsprechenden Maßnahmen zu ergreifen, um auf das Ereignis zu reagieren. In einem Google Workspace-Add‑on, das Gmail erweitert, können Sie beispielsweise einen Trigger definieren, der eine neue Kartenoberfläche erstellt, wenn der Nutzer einen Nachrichten-Thread öffnet. In diesem Fall implementieren Sie eine kontextbezogene Callback-Funktion, um die Karten zu erstellen, aus denen die neue Benutzeroberfläche besteht. Dabei werden die Daten verwendet, die im Ereignisobjektübergeben wurden.

Auf dieser Seite finden Sie Richtlinien zur Verwendung von Triggern in Google Workspace-Add‑on-Projekten.

Manifest-Trigger

Im Gegensatz zu Editor-Add‑ons können Google Workspace-Add‑ons keine einfachen Triggervon Google Apps Scriptverwenden. Stattdessen werden Trigger verwendet, die speziell für Google Workspace-Add‑ons entwickelt wurden: Manifest-Trigger.

Manifest-Trigger werden im Google Workspace-Add‑on Manifest definiert. Beispiele:

  • Startseitentrigger , die die Startseite des Add‑ons erstellen und anzeigen.
  • Google Kalender-Trigger für das Öffnen von Terminen , die eine neue Karte anzeigen oder andere Aktionen ausführen, wenn ein Termin geöffnet wird.
  • Kalender-Trigger für das Aktualisieren von Terminen , die eine neue Karte anzeigen oder andere Aktionen ausführen, wenn ein Nutzer einen Termin bearbeitet und speichert.
  • Google Drive-Trigger für die Auswahl von Elementen , die eine neue Karte anzeigen oder andere Aktionen ausführen, wenn ein Nutzer Dateien oder Ordner auswählt.
  • Gmail-Trigger für das Verfassen von Nachrichten , die eine Add‑on-Karte anzeigen, wenn der Nutzer das Add‑on im Fenster zum Verfassen von Nachrichten öffnet.
  • Kontextbezogene Gmail-Trigger , die eine neue Karte anzeigen oder andere Aktionen ausführen, wenn der Nutzer eine Nachricht öffnet.
  • Editor-Trigger für die Gewährung des Dateibereichs , die eine neue Karte anzeigen, wenn Nutzer die Autorisierung für den OAuth-Bereich drive.file im Dokument gewähren.

In der Liste sind nur Startseitentrigger nicht kontextbezogen, die übrigen sind kontextbezogen. Weitere Informationen zu Manifest-Triggerdefinitionen finden Sie unter Manifest für.

Neben Manifest-Triggern können Google Workspace Add‑ons auch installierbare Trigger von Apps Script verwenden.

Einschränkungen

Für die Verwendung von Manifest-Triggern gelten bestimmte Einschränkungen.

  • Diese Trigger werden nur in Google Workspace-Add‑on-Projekten verwendet.
  • Da sie im Add‑on-Manifest und nicht im Code definiert sind, können Sie sie nicht mit dem Apps Script Script-Dienst erstellen oder ändern.
  • Kontextbezogene Gmail-Trigger werden für jede E‑Mail-Nachricht ausgelöst, unabhängig vom Inhalt.
  • Jedes Add‑on kann nur einen Trigger jedes Typs pro Nutzer und pro Dokument haben.