Les objets Action vous permettent d'intégrer un comportement interactif
aux modules complémentaires Google Workspace. Ils définissent ce qui se passe lorsqu'un utilisateur interagit avec un widget (par exemple, un bouton) dans l'interface utilisateur du module complémentaire.
Une action est associée à un widget donné à l'aide d'une fonction de gestionnaire de widget, qui définit également la condition qui déclenche l'action. Lorsqu'elle est déclenchée, l' action exécute une fonction de rappel désignée. La fonction de rappel reçoit un objet d'événement qui contient des informations sur les interactions côté client de l'utilisateur. Vous devez implémenter la fonction de rappel et la faire renvoyer un objet de réponse spécifique.
Supposons, par exemple, que vous souhaitiez un bouton qui crée et affiche une nouvelle fiche lorsque l'utilisateur clique dessus. Pour ce faire, vous devez créer un widget de bouton et utiliser la fonction de gestionnaire de widget de bouton
setOnClickAction(action)
pour définir une Action de création de fiche. Le
Action que vous définissez spécifie une fonction de rappel Apps Script
qui s'exécute lorsque l'utilisateur clique sur le bouton. Dans ce cas, vous
implémentez la fonction de rappel pour créer la fiche souhaitée et renvoyer un
ActionResponse
objet. L'objet de réponse indique au module complémentaire d'afficher la fiche créée par la fonction de rappel.
Cette page décrit les actions de widget spécifiques à Gmail que vous pouvez inclure dans votre module complémentaire.
Interactions Gmail
Les modules complémentaires Google Workspace qui étendent Gmail peuvent inclure une action de widget supplémentaire spécifique à Gmail pour rédiger des brouillons. Cette action nécessite que la fonction de rappel d'action associée renvoie un objet de réponse spécialisé :
| Action tentée | Fonction de rappel à renvoyer |
|---|---|
| Rédiger des brouillons | ComposeActionResponse |
Pour utiliser ces actions de widget et ces objets de réponse, le
module complémentaire Google Workspace doit inclure le
https://www.googleapis.com/auth/gmail.addons.current.action.compose
champ d'application dans son
fichier manifeste.
Rédigez un message
Les modules complémentaires qui étendent Gmail peuvent définir un widget qui, lorsqu'il est utilisé, génère des brouillons dans Gmail (nouveaux messages ou réponses). Pour ce faire,ys
associez le widget déclencheur à une fonction de rappel qui renvoie un
ComposeActionResponse
objet. Une fois l'exécution de la fonction de rappel terminée, Gmail utilise cet objet de réponse pour ouvrir et remplir une fenêtre de brouillon.
Pour en savoir plus et obtenir un exemple, consultez la section Rédiger des brouillons.