Les objets Action vous permettent de créer un comportement interactif dans les 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'UI 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 lui demander de renvoyer un objet de réponse spécifique.
Par exemple, imaginons que vous souhaitiez qu'un bouton crée et affiche une nouvelle fiche lorsqu'il est cliqué. 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 un Action de création de cartes. La 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 objet ActionResponse. 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 spécifique à Gmail pour rédiger des brouillons de messages. Cette action nécessite que la fonction de rappel de l'action associée renvoie un objet de réponse spécialisé:
| Action tentée | La fonction de rappel doit renvoyer |
|---|---|
| Rédiger des brouillons de messages | ComposeActionResponse |
Pour utiliser ces actions de widget et ces objets de réponse, le module complémentaire doit inclure le champ d'application https://www.googleapis.com/auth/gmail.addons.current.action.compose dans son fichier manifeste.
Rédigez un message
Un module complémentaire Google Workspace qui étend Gmail peut définir un widget qui, lorsqu'il est utilisé, génère des messages d'envoi différé dans Gmail (nouveaux messages ou réponses). Pour ce faire, vous devez associer le widget déclencheur à une fonction de rappel qui renvoie un objet ComposeActionResponse. Lorsque la fonction de rappel a terminé son exécution, Gmail utilise cet objet de réponse pour ouvrir et renseigner une fenêtre de composition de brouillon.
Pour en savoir plus et obtenir un exemple, consultez la section Rédiger des brouillons de messages.