Działania jednym kliknięciem

Działania jednym kliknięciem umożliwiają użytkownikom wykonywanie operacji bezpośrednio ze skrzynki odbiorczej bez konieczności opuszczania Gmaila. Działania wykonywane jednym kliknięciem są realizowane przez zadeklarowanie elementu HttpActionHandler z adresem URL usługi. Więcej informacji znajdziesz w artykule Obsługa żądań działań.

Przycisk potwierdzenia w Gmailu
Działania w Gmailu, które można wykonać jednym kliknięciem.

Przypadki użycia

Obecnie w Gmailu obsługiwane są te działania jednym kliknięciem:

Potwierdź działanie

Do e-maili, które wymagają od użytkowników zatwierdzenia, potwierdzenia lub zaakceptowania czegoś, możesz dodać przycisk potwierdzenia jednym kliknięciem. Gdy użytkownik kliknie przycisk, Google wyśle do Twojej usługi żądanie HTTP, aby zarejestrować potwierdzenie. ConfirmAction można użyć tylko raz.

Poniższa deklaracja dodaje przycisk ConfirmAction do e-maila z raportem wydatków:

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>

Mikrodane

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

Zapisz zdjęcie pełne akcji

SaveAction może służyć do opisywania interakcji, takich jak zapisanie kuponu lub dodanie utworów do kolejki odtwarzania. SaveAction można użyć tylko raz.

Poniższa deklaracja dodaje SaveAction przycisk do e-maila z ofertą:

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>

Mikrodane

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

Sprawdź znaczniki

Znaczniki możesz sprawdzać za pomocą narzędzia do testowania znaczników e-maili. Wklej kod znaczników i kliknij przycisk Sprawdź, aby przeskanować treść i otrzymać raport o wszelkich błędach.

Specyfikacja

Właściwości dostępne w przypadku tych działań znajdziesz w dokumentacji dotyczącej konkretnych typów ConfirmAction i SaveAction.