Mit Action-Objekten können Sie in Google Workspace-Add-ons interaktive Funktionen einbinden. Sie definieren, was passiert, wenn ein Nutzer mit einem Widget (z. B. einer Schaltfläche) in der Add-on-Benutzeroberfläche interagiert.
Eine Aktion wird über eine Widget-Handlerfunktion an ein bestimmtes Widget angehängt. Diese Funktion definiert auch die Bedingung, die die Aktion auslöst. Wenn die Aktion ausgelöst wird, wird eine bestimmte Callback-Funktion ausgeführt. 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 sie so konfigurieren, dass sie ein bestimmtes Antwortobjekt zurückgibt.
Angenommen, Sie möchten eine Schaltfläche haben, die beim Klicken eine neue Karte erstellt und anzeigt. Dazu müssen Sie ein neues Schaltflächen-Widget erstellen und mit der Handlerfunktion für das Schaltflächen-Widget setOnClickAction(action) eine Karte Action festlegen. Mit der von Ihnen definierten Action wird eine Apps Script-Callback-Funktion angegeben, die ausgeführt wird, wenn auf die Schaltfläche geklickt wird. In diesem Fall implementieren Sie die Rückruffunktion, um die gewünschte Karte zu erstellen und ein ActionResponse-Objekt zurückzugeben. Das Antwortobjekt weist das Add-on an, die Karte anzuzeigen, die mit der Rückruffunktion erstellt wurde.
Auf dieser Seite werden Gmail-spezifische Widget-Aktionen beschrieben, die Sie in Ihr Add-on einbinden können.
Gmail-Interaktionen
Google Workspace-Add-ons, die Gmail erweitern, können eine zusätzliche Gmail-spezifische Widget-Aktion zum Erstellen von E-Mail-Entwürfen enthalten. Für diese Aktion muss die zugehörige Callback-Funktion ein spezielles Antwortobjekt zurückgeben:
| Versuchte Aktion | Die Callback-Funktion sollte Folgendes zurückgeben: |
|---|---|
| Nachrichtenentwürfe verfassen | ComposeActionResponse |
Damit diese Widget-Aktionen und Antwortobjekte verwendet werden können, muss das Add-on den https://www.googleapis.com/auth/gmail.addons.current.action.compose
scope in seinem Manifest enthalten.
Nachricht verfassen
Ein Google Workspace-Add-on, das Gmail erweitert, kann ein Widget definieren, das bei Interaktion E-Mail-Entwürfe in Gmail generiert (entweder neue E-Mails oder Antworten). Dazu müssen Sie das auslösende Widget mit einer Callback-Funktion verknüpfen, die ein ComposeActionResponse-Objekt zurückgibt. Wenn die Ausführung der Rückruffunktion abgeschlossen ist, verwendet Gmail dieses Antwortobjekt, um ein Fenster zum Erstellen von Entwürfen zu öffnen und zu füllen.
Weitere Informationen und ein Beispiel finden Sie unter Entwürfe von Nachrichten verfassen.