Acciones con un solo clic

Las acciones con un solo clic permiten a los usuarios realizar operaciones directamente desde Recibidos sin tener que salir de Gmail. Las acciones de un clic se realizan mediante la declaración de HttpActionHandler con la URL de servicio. Para obtener más información, consulta Cómo controlar las solicitudes de acción.

Un botón de confirmación en Gmail
Acciones con un clic en Gmail.

Casos de uso

Actualmente, las acciones con un clic que se admiten en Gmail son las siguientes:

Confirmar acción

Puedes agregar un botón de confirmación con un clic a los correos electrónicos para que los usuarios deban aprobar, confirmar y reconocer algo. Una vez que el usuario haga clic en el botón, se emitirá una solicitud HTTP a tu servicio y se registrará la confirmación. Solo se puede interactuar con ConfirmAction una vez.

En la siguiente declaración, se agrega un botón ConfirmAction a un correo electrónico sobre un informe de gastos:

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>

Microdatos

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

Guardar acción

SaveAction se puede usar para describir interacciones, como guardar un cupón o agregar canciones a la fila de reproducción. Solo se puede interactuar con SaveAction una vez.

La siguiente declaración agrega un botón SaveAction a un correo electrónico sobre una 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>

Microdatos

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

Prueba tu lenguaje de marcado

Puedes validar el lenguaje de marcado con la Herramienta de prueba de lenguaje de marcado de correo electrónico. Pega el código de marcado y haz clic en el botón Validar para analizar el contenido y recibir un informe de los errores presentes.

Especificación

Si quieres conocer las propiedades disponibles para estas acciones, consulta la documentación de los tipos específicos ConfirmAction y SaveAction.