Działania wykonywane jednym kliknięciem

Dzięki działaniom wykonywanym jednym kliknięciem użytkownicy mogą wykonywać operacje bezpośrednio ze skrzynki odbiorczej bez opuszczania Gmaila. Działania wykonywane jednym kliknięciem są realizowane przez zadeklarowanie HttpActionHandler z adresem URL usługi. Więcej informacji znajdziesz w artykule Obsługa żądań działań.

Działania w Gmailu wykonywane jednym kliknięciem

Przypadki użycia

Działania jednym kliknięciem obsługiwane w Gmailu to:

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 zapisywanie kuponu lub dodawanie utworów do kolejki odtwarzania. Z elementem SaveAction można wejść w interakcję tylko raz.

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

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ą Testera znaczników w e-mailu. Wklej kod znaczników i kliknij przycisk Sprawdź, aby przeskanować treść i otrzymać raport o wszystkich 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.