Halaman ini diterjemahkan oleh Cloud Translation API.

Tindakan Sekali Klik

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

Tindakan sekali klik di Gmail.

Kasus Penggunaan

Tindakan Sekali Klik yang saat ini didukung di Gmail adalah:

ConfirmAction
SaveAction

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, yang merekam konfirmasi. ConfirmAction hanya dapat berinteraksi satu kali.

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 mendeskripsikan interaksi seperti menyimpan kupon atau menambahkan lagu ke antrean pemutaran. SaveAction hanya dapat berinteraksi satu kali.

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

Uji markup Anda

Anda dapat memvalidasi markup menggunakan Alat Penguji Markup Email. Tempelkan kode markup, lalu klik tombol Validasi untuk memindai konten dan menerima laporan tentang error yang ada.

Spesifikasi

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