Halaman ini diterjemahkan oleh Cloud Translation API.

Tindakan Sekali Klik

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

Tindakan sekali klik di Gmail.

Kasus Penggunaan

Tindakan Satu Klik yang saat ini didukung di Gmail adalah:

ConfirmAction
SaveAction

Mengonfirmasi Tindakan

Anda dapat menambahkan tombol konfirmasi sekali klik ke email yang mengharuskan pengguna menyetujui, mengonfirmasi, dan mengonfirmasi sesuatu. Setelah pengguna mengklik tombol, permintaan http akan dikeluarkan dari Google ke layanan Anda, yang 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 mendeskripsikan interaksi seperti menyimpan kupon atau menambahkan lagu ke antrean dengar. 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 Pengujian Markup Email. Tempelkan kode markup Anda dan klik tombol Validasi untuk memindai konten dan menerima laporan tentang error yang ada.

Spesifikasi

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