Tindakan Sekali Klik

Tindakan sekali klik memungkinkan pengguna untuk melakukan operasi langsung dari kotak masuk tanpa harus keluar dari Gmail. Tindakan sekali klik dilakukan dengan mendeklarasikan HttpActionHandler bersama URL layanan Anda. Untuk mengetahui detail selengkapnya, lihat Menangani Permintaan Tindakan.

Tombol Konfirmasi di Gmail
Tindakan sekali klik di Gmail.

Kasus Penggunaan

Tindakan Sekali Klik yang saat ini didukung di Gmail adalah:

Konfirmasi Tindakan

Anda dapat menambahkan tombol konfirmasi sekali klik ke email yang mengharuskan pengguna untuk menyetujui, mengonfirmasi, dan mengonfirmasi sesuatu. Setelah pengguna mengklik tombol tersebut, permintaan http akan dikeluarkan dari Google ke layanan Anda, mencatat konfirmasi. ConfirmAction hanya dapat berinteraksi sekali.

Deklarasi berikut menambahkan tombol ConfirmAction ke email tentang laporan pengeluaran:

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>

Microdata

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

Simpan Tindakan

SaveAction dapat digunakan untuk menjelaskan interaksi seperti menyimpan kupon atau menambahkan lagu ke antrean mendengarkan. SaveAction hanya dapat berinteraksi sekali.

Deklarasi berikut menambahkan tombol SaveAction ke email tentang penawaran:

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>

Microdata

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

Menguji Markup

Anda dapat memvalidasi markup menggunakan Alat Penguji Markup Email. Tempel kode markup Anda dan klik tombol Validasi untuk memindai konten dan menerima laporan jika ada error.

Spesifikasi

Guna mengetahui properti yang tersedia untuk tindakan ini, lihat dokumentasi untuk jenis tertentu ConfirmAction dan SaveAction.