Actions Gmail

Les objets Action vous permettent de créer un comportement interactif dans les modules complémentaires Google Workspace. Elles 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 widgets, 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 mettre en œuvre la fonction de rappel et faire en sorte qu'elle renvoie un objet de réponse spécifique.

Par exemple, supposons que vous souhaitiez qu'un bouton génère 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 widgets de bouton setOnClickAction(action) pour définir un Action de création de cartes. L'élément 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, implémentez la fonction de rappel pour créer la carte de votre choix 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 permettant de 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é:

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 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 les fonctionnalités de Gmail peut définir un widget qui, lors d'une interaction, génère des brouillons dans Gmail (nouveaux messages ou réponses). Pour ce faire, vous devez associer le widget de déclenchement à une fonction de rappel qui renvoie un objet ComposeActionResponse. Une fois l'exécution de la fonction de rappel terminée, Gmail utilise cet objet de réponse pour ouvrir et remplir un brouillon de fenêtre de rédaction.

Pour en savoir plus et obtenir un exemple, consultez la page Rédiger des brouillons.