Gmail-Aktionen

Action-Objekten können Sie interaktives Verhalten in Google Workspace-Add‑ons einbauen. Sie definieren, was passiert, wenn ein Nutzer mit einem Widget (z. B. einer Schaltfläche) in der Add‑on-UI interagiert.

Eine Aktion wird einem bestimmten Widget mithilfe einer Widget-Handler-Funktion, die auch die Bedingung definiert, die die Aktion auslöst, zugewiesen. Wenn die Aktion ausgelöst wird, führt sie eine bestimmte Callback-Funktionaus. Der 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, die beim Klicken eine neue Karte erstellt und anzeigt. Dazu müssen Sie ein neues Schaltflächen-Widget erstellen und mit der Schaltflächen-Widget Handler-Funktion setOnClickAction(action) eine Karte erstellende Action festlegen. Die Action von Ihnen definierte gibt eine Apps Script Callback-Funktion an, 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 von der Callback-Funktion erstellte Karte anzuzeigen.

Auf dieser Seite werden Gmail-spezifische Widget-Aktionen beschrieben, die Sie in Ihr Add‑on einfügen können.

Gmail-Interaktionen

Google Workspace-Add‑ons, die Gmail erweitern, können eine zusätzliche Gmail-spezifische Widget-Aktion zum Verfassen von Nachrichtenentwürfen enthalten. Für diese Aktion muss die zugehörige Aktion Callback-Funktion ein spezielles Antwortobjekt zurückgeben:

Versuchte Aktion	Callback-Funktion sollte zurückgeben
Nachrichtenentwürfe verfassen	ComposeActionResponse

Damit diese Widget-Aktionen und Antwortobjekte verwendet werden können, muss das Google Workspace-Add‑on den https://www.googleapis.com/auth/gmail.addons.current.action.compose Bereich in seinem Manifest enthalten.

Nachricht verfassen

Add‑ons, die Gmail erweitern, können ein Widget definieren, das beim Interagieren Nachrichtenentwürfe in Gmail erstellt (entweder neue Nachrichten oder Antworten). Dazu müssen Sie das auslösende Widget einer Callback-Funktion zuordnen,die ein ComposeActionResponse Objekt zurückgibt. Wenn die Ausführung der Callback-Funktion abgeschlossen ist, öffnet und füllt Gmail mit diesem Antwortobjekt ein Fenster zum Verfassen von Nachrichtenentwürfen.

Weitere Informationen und ein Beispiel finden Sie unter Nachrichtenentwürfe verfassen.