Azioni con un solo clic

Le azioni con un solo clic consentono agli utenti di eseguire operazioni direttamente dalla posta in arrivo senza dover uscire da Gmail. Le azioni con un clic vengono eseguite dichiarando un HttpActionHandler con l'URL del servizio. Per ulteriori dettagli, consulta la sezione Gestione delle richieste di azioni.

Un pulsante di conferma in Gmail
Azioni con un clic in Gmail.

Casi d'uso

Le azioni con un clic attualmente supportate in Gmail sono:

Conferma azione

Puoi aggiungere un pulsante di conferma con un clic alle email che richiedono agli utenti di approvare, confermare e riconoscere qualcosa. Quando l'utente fa clic sul pulsante, Google invia una richiesta HTTP al tuo servizio, registrando la conferma. È possibile interagire con ConfirmAction solo una volta.

La seguente dichiarazione aggiunge un pulsante ConfirmAction a un'email relativa a una nota spese:

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>

Microdati

<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>

Salva azione

SaveAction può essere utilizzato per descrivere interazioni come il salvataggio di un coupon o l'aggiunta di brani alla coda di ascolto. È possibile interagire con SaveAction solo una volta.

La seguente dichiarazione aggiunge un pulsante SaveAction a un'email relativa a un'offerta:

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>

Microdati

<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>

Verifica il codice di markup

Puoi convalidare il markup utilizzando lo Strumento di test del markup delle email. Incolla il codice di markup e fai clic sul pulsante Convalida per analizzare i contenuti e ricevere un report sugli eventuali errori presenti.

Specifica

Per le proprietà disponibili per queste azioni, consulta la documentazione per i tipi specifici ConfirmAction e SaveAction.