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. Les actions en un clic sont effectuées en déclarant 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 en un clic dans Gmail.

Cas d'utilisation

Voici les actions en un clic actuellement disponibles dans Gmail :

Confirmer l'action

Vous pouvez ajouter un bouton de confirmation en un clic aux e-mails demandant aux utilisateurs d'approuver, de confirmer ou d'accuser réception d'un élément. Une fois que l'utilisateur a cliqué sur le bouton, une requête HTTP est envoyée par Google à 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 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. 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 d'e-mails. Collez votre code de balisage, puis cliquez sur le bouton Valider pour analyser le contenu et obtenir un rapport sur les éventuelles erreurs.

Spécification

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