Gmail-Aktionen

Mit Action-Objekten können Sie interaktive Elemente Google Workspace-Add-ons. Sie definieren was passiert, wenn Nutzende mit einem Widget (z. B. einer Schaltfläche) in der Add-on-Benutzeroberfläche.

Eine Aktion wird mithilfe eines widget-Handler-Funktion, definiert auch die Bedingung, die die Aktion auslöst. Wenn der Parameter ausgelöst wird, einer bestimmten Aktion eine bestimmte Callback-Funktion zu. Der Callback-Funktion wird ein Ereignisobjekt, das Informationen zu den clientseitigen Interaktionen des Nutzers. Sie müssen die -Callback-Funktion hinzu, die ein bestimmtes Antwortobjekt zurückgibt.

Angenommen, Sie möchten eine Schaltfläche, die beim Erstellen und Anzeigen einer neuen Karte angeklickt wurde. Dazu müssen Sie ein neues Schaltflächen-Widget erstellen und das Schaltflächen-Widget Handler-Funktion setOnClickAction(action) um eine Karte zum Erstellen von Action festzulegen. Die Mit Action, den Sie definieren, wird ein Apps Script angegeben Callback-Funktion, die beim Klicken auf die Schaltfläche ausgeführt wird. In diesem Fall Implementieren Sie die Callback-Funktion, um die gewünschte Karte zu erstellen und eine ActionResponse -Objekt enthält. Das Antwortobjekt weist das Add-on an, die Karte anzuzeigen, die der Callback enthält. erstellt.

Auf dieser Seite werden Gmail-spezifische Widget-Aktionen beschrieben, die Sie in Ihren Add-on.

Interaktionen mit Gmail

Google Workspace-Add-ons, die Gmail erweitern, können Folgendes umfassen: eine zusätzliche Gmail-Widget-Aktion zum Verfassen von Nachrichtenentwürfen. Dieses Aktion erfordert die zugehörige Aktion Callback-Funktion ein spezielles Antwortobjekt zurückzugeben:

Aktion versucht Die Callback-Funktion sollte Folgendes zurückgeben:
Nachrichtenentwürfe verfassen ComposeActionResponse

Um diese Widgetaktionen und Antwortobjekte nutzen zu können, muss das Add-on einschließlich der https://www.googleapis.com/auth/gmail.addons.current.action.compose scope im Manifest.

Nachricht verfassen

Ein Google Workspace-Add-on, das Gmail erweitert, kann Ein Widget definieren, das bei Interaktionen Entwürfe in Gmail generiert (neue Nachrichten oder Antworten). Dazu müssen Sie den Trigger Widget mit einer Callback-Funktion, die ein ComposeActionResponse -Objekt enthält. Nach der Ausführung der Callback-Funktion wird in Gmail Folgendes verwendet: Antwortobjekt, um ein Fenster zum Verfassen des Entwurfs zu öffnen und auszufüllen.

Weitere Details und ein Beispiel finden Sie unter Nachrichtenentwürfe verfassen