Actions en un clic

Les actions en un clic permettent aux utilisateurs d'effectuer des opérations directement depuis leur boîte de réception, sans quitter Gmail. Pour effectuer des actions en un clic, vous devez déclarer un HttpActionHandler avec l'URL de votre service. Pour en savoir plus, consultez la section Traiter les requêtes d'action.

Actions en un clic dans Gmail

Cas d'utilisation

Les actions en un clic compatibles avec 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 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 de Google à votre service, enregistrant ainsi la confirmation. L'action ConfirmAction ne peut être effectuée 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 coupon ou l'ajout de titres à la file d'attente d'écoute. L'action SaveAction ne peut être effectuée 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 de 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 éventuelles.

Spécification

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