Acciones con un solo clic

Las acciones con 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, 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

Las acciones de un clic que se admiten actualmente en Gmail son las siguientes:

Confirma la acción

Puedes agregar un botón de confirmación con un clic a los correos electrónicos que requieran 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

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 tu lenguaje de marcado con la Herramienta de prueba de lenguaje de marcado de correo electrónico. Pega tu código de lenguaje de marcado y haz clic en el botón Validar 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.