Les actions en un clic permettent aux utilisateurs d'effectuer des opérations directement depuis la boîte de réception sans avoir à quitter Gmail. Les actions en un clic sont effectuées en déclarant un HttpActionHandler
avec l'URL de votre service. Pour en savoir plus, consultez Gérer les demandes d'action.
![Un bouton de confirmation dans Gmail](https://developers-dot-devsite-v2-prod.appspot.com/gmail/markup/images/actions-one-click-action.png?authuser=6&hl=fr)
Actions en un clic dans Gmail.
Cas d'utilisation
Voici les actions en un clic actuellement prises en charge dans Gmail:
Confirmer l'action
Vous pouvez ajouter un bouton de confirmation en un clic aux e-mails qui demandent aux utilisateurs d'approuver, de confirmer et de confirmer quelque chose. Lorsque l'utilisateur clique sur le bouton, Google envoie une requête HTTP à votre service et enregistre la confirmation. Vous ne pouvez interagir avec ConfirmAction
qu'une seule fois.
La déclaration suivante ajoute un bouton ConfirmAction
à un e-mail concernant une note de frais:
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "ConfirmAction",
"name": "Approve Expense",
"handler": {
"@type": "HttpActionHandler",
"url": "https://myexpenses.com/approve?expenseId=abc123"
}
},
"description": "Approval request for John's $10.13 expense for office supplies"
}
</script>
Microdonnées
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ConfirmAction">
<meta itemprop="name" content="Approve Expense"/>
<div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
<link itemprop="url" href="https://myexpenses.com/approve?expenseId=abc123"/>
</div>
</div>
<meta itemprop="description" content="Approval request for John's $10.13 expense for office supplies"/>
</div>
Enregistrer l'action
SaveAction
peut être utilisé pour décrire des interactions telles que l'enregistrement d'un bon de réduction ou l'ajout de titres à la file d'attente d'écoute. Vous ne pouvez interagir avec SaveAction
qu'une seule fois.
La déclaration suivante ajoute un bouton SaveAction
à un e-mail concernant une offre:
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "SaveAction",
"name": "Save Offer",
"handler": {
"@type": "HttpActionHandler",
"url": "https://offers-everywhere.com/save?offerId=xyz789"
}
},
"description": "$5 meal at Joe's Diner"
}
</script>
Microdonnées
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/SaveAction">
<meta itemprop="name" content="Save Offer"/>
<div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
<link itemprop="url" href="https://offers-everywhere.com/save?offerId=xyz789"/>
</div>
</div>
<meta itemprop="description" content="$5 meal at Joe's Diner"/>
</div>
Tester le balisage
Vous pouvez valider votre balisage à l'aide de l'outil de test du balisage des e-mails. Collez votre code de balisage, puis cliquez sur le bouton Valider pour analyser le contenu et recevoir un rapport sur les éventuelles erreurs.
Spécification
Pour connaître les propriétés disponibles pour ces actions, reportez-vous à la documentation les types spécifiques ConfirmAction et SaveAction.