Działania jednym kliknięciem

Dzięki działaniom wykonywanym jednym kliknięciem użytkownicy mogą wykonywać operacje bezpośrednio ze skrzynki odbiorczej bez wychodzenia z 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 wykonywane jednym kliknięciem w Gmailu.

Przypadki użycia

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

Potwierdź działanie

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

Poniższa deklaracja dodaje przycisk ConfirmAction do e-maila dotyczącego raportu 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 działanie

Element SaveAction może służyć do opisywania interakcji, takich jak zapisywanie kuponu lub dodawanie utworów do kolejki odtwarzania. Z elementem SaveAction można wejść w interakcję tylko raz.

Poniższa deklaracja dodaje przycisk SaveAction do e-maila dotyczącego oferty:

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 Tester znaczników w e-mailu Email Markup Tester Tool. Wklej kod znaczników i kliknij przycisk Sprawdź , aby przeskanować treść i otrzymać raport o ewentualnych błędach.

Specyfikacja

Informacje o właściwościach dostępnych w przypadku tych działań znajdziesz w dokumentacji dotyczącej konkretnych typów ConfirmAction i SaveAction.