Mit Action-Objekten können Sie Google Workspace-Add-ons interaktives Verhalten integrieren. Sie definieren, was passiert, wenn ein Nutzer mit einem Widget (z. B. einer Schaltfläche) in der Add-on-UI interagiert.
Eine Aktion wird mithilfe einer Widget-Handler-Funktion an ein bestimmtes Widget angehängt. Damit wird auch die Bedingung definiert, die die Aktion auslöst. Bei Auslösung führt die Aktion eine vorgesehene Callback-Funktion aus. An die Callback-Funktion wird ein Ereignisobjekt übergeben, das Informationen zu den clientseitigen Interaktionen des Nutzers enthält. Sie müssen die Callback-Funktion implementieren und ein bestimmtes Antwortobjekt zurückgeben lassen.
Angenommen, Sie möchten eine Schaltfläche, mit der beim Anklicken eine neue Karte erstellt und angezeigt wird. Dazu müssen Sie ein neues Schaltflächen-Widget erstellen und die Handler-Funktion setOnClickAction(action) für das Schaltflächen-Widget verwenden, um ein Kartenerstellungs-Action festzulegen. Mit dem von Ihnen definierten Action wird eine Apps Script-Callback-Funktion definiert, die ausgeführt wird, wenn auf die Schaltfläche geklickt wird. In diesem Fall implementieren Sie die Callback-Funktion, um die gewünschte Karte zu erstellen und ein ActionResponse-Objekt zurückzugeben. Das Antwortobjekt weist das Add-on an, die Karte anzuzeigen, die die Callback-Funktion erstellt hat.
Auf dieser Seite werden Gmail-spezifische Widget-Aktionen beschrieben, die Sie Ihrem Add-on hinzufügen können.
Gmail-Interaktionen
Google Workspace-Add-ons, die Gmail erweitern, können eine zusätzliche Gmail-spezifische Widgetaktion zum Schreiben von Nachrichtenentwürfen enthalten. Für diese Aktion ist die zugehörige Callback-Funktion erforderlich, um ein spezialisiertes Antwortobjekt zurückzugeben:
| Aktion versucht | Callback-Funktion sollte |
|---|---|
| E-Mail-Entwürfe verfassen | ComposeActionResponse |
Damit Sie diese Widget-Aktionen und -Antwortobjekte verwenden können, muss das Add-on den Bereich https://www.googleapis.com/auth/gmail.addons.current.action.compose in seinem Manifest enthalten.
Nachricht schreiben
In einem Google Workspace-Add-on, das Gmail erweitert, kann ein Widget definiert werden, das bei Interaktion Nachrichtenentwürfe in Gmail generiert (entweder neue Nachrichten oder Antworten). Dazu musst du das auslösende Widget mit einer Callback-Funktion verknüpfen, die ein ComposeActionResponse-Objekt zurückgibt. Wenn die Ausführung der Callback-Funktion abgeschlossen ist, verwendet Gmail dieses Antwortobjekt, um ein Fenster zum Schreiben eines Entwurfs zu öffnen und auszufüllen.
Weitere Informationen und ein Beispiel finden Sie unter Nachrichtenentwürfe verfassen.