Acciones con un solo clic

Las acciones de un clic permiten a los usuarios realizar operaciones directamente desde la carpeta Recibidos sin tener que salir de Gmail. Para realizar acciones de un clic, se declara un HttpActionHandler con la URL de tu servicio. Para obtener más detalles, consulta Cómo manejar solicitudes de acción.

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

Casos de uso

Actualmente, las acciones de un clic compatibles con Gmail son las siguientes:

Confirmar acción

Puedes agregar un botón de confirmación de un clic a los correos electrónicos que requieren que los usuarios aprueben, confirmen y reconozcan algo. Una vez que el usuario haga clic en el botón, Google enviará una solicitud HTTP a tu servicio para registrar la confirmación. Solo se puede interactuar con ConfirmAction una vez.

La siguiente declaración 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 imagen de acción

Se puede usar SaveAction para describir interacciones como guardar un cupón o agregar canciones a la cola 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 tu lenguaje de marcado con la herramienta de prueba de lenguaje de marcado de correo electrónico. Pega el código de lenguaje de marcado y haz clic en el botón Validate para analizar el contenido y recibir un informe sobre los errores presentes.

Especificación

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