Les objets Action vous permettent de créer
dans les modules complémentaires Google Workspace. Elles définissent
que se passe-t-il lorsqu'un utilisateur interagit avec un widget (par exemple, un bouton) dans
l'UI du module complémentaire.
Une action est associée à un widget donné à l'aide d'un Fonction de gestionnaire de widgets qui définit également la condition qui déclenche l'action. Lorsqu'elle est déclenchée, exécute une opération fonction de rappel. La fonction de rappel reçoit une objet "event", qui contient des informations sur les interactions de l'utilisateur côté client. Vous devez mettre en œuvre de rappel et lui demander de renvoyer un objet de réponse spécifique.
Par exemple, supposons que vous souhaitiez un bouton qui crée et affiche une nouvelle carte lorsque
sur lesquels l'utilisateur a cliqué. Pour ce faire, vous devez créer un widget de bouton et utiliser le widget Bouton
Fonction de gestionnaire
setOnClickAction(action)
pour définir un Action de création de cartes. La
Action que vous définissez spécifie un Apps Script.
de rappel qui s'exécute lorsque l'utilisateur clique sur le bouton. Dans ce cas, vous
implémenter la fonction de rappel pour créer la carte souhaitée et renvoyer une
ActionResponse
. L'objet de réponse indique au module complémentaire d'afficher la carte
de la fonction.
Cette page décrit les actions de widget spécifiques à Gmail que vous pouvez inclure dans vos un module complémentaire.
Interactions dans Gmail
Les modules complémentaires Google Workspace qui étendent Gmail peuvent inclure une action supplémentaire du widget Gmail pour rédiger des brouillons. Ce requiert l'action associée Fonction de rappel pour renvoyer un objet de réponse spécialisé:
| Tentative d'action | La fonction de rappel doit renvoyer |
|---|---|
| Rédiger des brouillons | ComposeActionResponse |
Pour utiliser ces actions de widget et ces objets de réponse, le module complémentaire doit
inclure les
https://www.googleapis.com/auth/gmail.addons.current.action.compose
scope dans son fichier manifeste.
Rédigez un message
Un module complémentaire Google Workspace qui étend Gmail peut
définir un widget qui, en cas d'interaction, génère des brouillons dans Gmail.
(nouveaux messages ou réponses). Pour ce faire, vous devez associer le déclencheur
avec une fonction de rappel qui renvoie
ComposeActionResponse
. Lorsque l'exécution de la fonction de rappel est terminée, Gmail l'utilise
de réponse pour ouvrir et remplir une fenêtre de rédaction de brouillon.
Pour en savoir plus et obtenir un exemple, consultez Rédiger des brouillons