Ações de um clique

Com as ações de um clique, os usuários podem realizar operações diretamente na caixa de entrada, sem precisar sair do Gmail. As ações de um clique são realizadas ao declarar um HttpActionHandler com o URL do serviço. Para saber mais, consulte Como processar solicitações de ações.

Ações de um clique no Gmail.

Casos de uso

Estas são as ações compatíveis com um clique no Gmail:

• ConfirmAction
• SaveAction

Confirmar ação

Você pode adicionar um botão de confirmação de um clique a e-mails que exijam 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 seu 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:

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

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

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

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

Teste sua marcação.

É possível validar sua marcação usando a ferramenta para testadores de marcação em e-mails. Cole seu código de marcação e clique no botão Validar para digitalizar o conteúdo e receber um relatório sobre os erros presentes.

Especificação

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