Actions en un clic

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. Pour effectuer des actions en un clic, déclarez un HttpActionHandler avec l'URL de votre service. Pour en savoir plus, consultez Traiter les requêtes d'action.

Bouton de confirmation dans Gmail
Actions rapides en un clic dans Gmail.

Cas d'utilisation

Les actions en un clic actuellement disponibles dans Gmail sont les suivantes:

Confirmer l'action

Vous pouvez ajouter un bouton de confirmation en un clic aux e-mails demandant aux utilisateurs d'approuver, de confirmer et de prendre acte de quelque chose. Une fois que l'utilisateur a cliqué sur le bouton, Google envoie une requête HTTP à votre service pour enregistrer la confirmation. Vous ne pouvez interagir avec ConfirmAction qu'une seule fois.

La déclaration suivante ajoute un bouton ConfirmAction à un e-mail concernant un rapport de dépenses:

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 erreurs détectées.

Spécification

Pour connaître les propriétés disponibles pour ces actions, consultez la documentation des types spécifiques ConfirmAction et SaveAction.