As ações com um clique permitem que os usuários realizem operações diretamente na caixa de entrada, sem precisar sair do Gmail. As ações de um clique são realizadas declarando um HttpActionHandler
com o URL do serviço. Para mais detalhes, consulte Como processar solicitações de ação.
![Um botão de confirmação no Gmail](https://developers-dot-devsite-v2-prod.appspot.com/gmail/markup/images/actions-one-click-action.png?authuser=9&hl=pt)
Ações com um clique no Gmail.
Casos de uso
Atualmente, as ações de um clique compatíveis com o Gmail são:
.Confirmar ação
Você pode adicionar um botão de confirmação com um clique aos e-mails que exigem que os usuários aprovem, confirmem e reconheçam algo. Quando o usuário clicar no botão, uma solicitação http será emitida pelo 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:
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 reproduçã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
É possível validar sua marcação usando a Ferramenta para testar a 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 conhecer as propriedades disponíveis para essas ações, consulte a documentação do tipos específicos ConfirmAction e SaveAction.