Ações com um clique

As ações com um clique permitem que os usuários realizem operações diretamente na caixa de entrada sem sair do Gmail. Elas são realizadas declarando um HttpActionHandler com o URL do serviço. Para mais detalhes, consulte Como processar solicitações de ação.

Ações com um clique no Gmail

Casos de uso

As ações com um clique compatíveis com o Gmail são:

Confirmar ação

É possível adicionar um botão de confirmação com um clique a e-mails que exigem que os usuários aprovem, confirmem e reconheçam algo. Quando o usuário clica no botão, uma solicitação HTTP é emitida do Google para o serviço, registrando a confirmação. Só é possível interagir com ConfirmAction uma vez.

A declaração a seguir adiciona um botão ConfirmAction a um e-mail sobre um relatório de despesas:

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>

Microdados

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

Salvar ação

SaveAction pode ser usado para descrever interações como salvar um cupom ou adicionar músicas à fila de audição. Só é possível interagir com SaveAction uma vez.

A declaração a seguir adiciona um botão SaveAction a um e-mail sobre uma oferta:

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>

Microdados

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

Testar sua marcação

Você pode validar sua marcação usando a Ferramenta para testar a marcação em e-mails. Cole o código de marcação e clique no botão Validar para analisar o conteúdo e receber um relatório sobre os erros presentes.

Especificação

Para conferir as propriedades disponíveis para essas ações, consulte a documentação dos tipos específicos ConfirmAction e SaveAction.