Acciones con un clic

Las acciones con un clic permiten que los usuarios realicen operaciones directamente desde la bandeja de entrada sin salir de Gmail. Para realizar acciones con un clic, se declara un HttpActionHandler con la URL de tu servicio. Para obtener más detalles, consulta cómo controlar las solicitudes de acción.

Acciones con un clic en Gmail

Casos de uso

Las acciones con un clic compatibles con Gmail son las siguientes:

Confirmar acción

Puedes agregar un botón de confirmación con un clic a los correos electrónicos que requieren que los usuarios aprueben, confirmen y reconozcan algo. Una vez que el usuario hace clic en el botón, Google envía una solicitud HTTP a tu servicio, que registra 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.