Ringkasan

Partner yang berpartisipasi dalam program Daftar Tunggu Reservasi harus menyelesaikan Penyiapan akun sebelum dimulai. Namun, beberapa langkah dalam panduan umum tidak diperlukan untuk penggunaan fitur daftar tunggu. Panduan di halaman ini menjelaskan langkah-langkah yang berlaku bagi partner yang tertarik untuk menggunakan fitur daftar tunggu di Pesan dengan Google. Sebaiknya baca ringkasan ini sebelum melakukan langkah-langkah integrasi.

Proses peluncuran

Gambar 1 menguraikan proses untuk meluncurkan penjual Anda yang mengaktifkan daftar tunggu di Actions Center.

Gambar 1: Langkah integrasi tingkat tinggi
Gambar 1: Langkah integrasi tingkat tinggi

Secara keseluruhan, aliran data utama antara Anda (Partner) dan Google digambarkan pada Gambar 2:

Gambar 2: Diagram alur data integrasi
Gambar 2: Diagram alur data integrasi

Panduan untuk semua partner Daftar Tunggu Reservasi

Perhatikan hal-hal berikut saat Anda menerapkan fitur Daftar Tunggu Reservasi:

  • Layanan untuk setiap penjual Daftar Tunggu Reservasi harus telah waitlist_rules terisi.
    • Anda harus menggunakan layanan yang sama untuk daftar tunggu dan reservasi. Dengan kata lain, jika restoran Anda juga mengizinkan reservasi, cukup tambahkan metadata terkait daftar tunggu ke layanan untuk reservasi.
  • Pengiriman info terbaru melalui SMS diperlukan untuk penerapan daftar tunggu dalam kasus berikut:
    • Untuk mengonfirmasi bahwa pengguna telah berhasil bergabung ke daftar tunggu.
    • Untuk memberi tahu pengguna bahwa tabel mereka sudah siap.
    • Untuk memberi tahu pengguna bahwa entri daftar tunggunya telah dibatalkan.
  • Pesan SMS harus berisi link ke halaman tempat pengguna dapat melihat status daftar tunggu mereka.
  • Penjual khusus daftar tunggu tidak perlu memberikan feed ketersediaan ke Actions Center.
  • Server pemesanan Anda harus menerapkan semua langkah khusus daftar tunggu yang tercantum dalam Menerapkan server pemesanan. Partner yang mendukung reservasi dan daftar tunggu dapat menambahkan metode baru ke server pemesanan yang ada.
  • Pusat Tindakan menjalankan serangkaian kasus pengujian untuk metode daftar tunggu di server pemesanan.

Diagram alir status

Diagram ini menjelaskan status yang harus dilaporkan dalam WaitlistEntry.waitlist_entry_state saat merespons panggilan GetWaitlistEntry . Diagram ini juga menunjukkan kapan harus merekam dan mengisi kolom WaitlistEntry.waitlist_entry_state_times.*_time_seconds serta kapan mengirim SMS kepada pengguna untuk memberi tahu mereka bahwa mereka telah memasuki status baru.

Gambar 3: Flowchart status daftar tunggu
Gambar: 3 Diagram alur status daftar tunggu

Kasus ekstrem umum

Berikut adalah kasus ekstrem umum dalam integrasi Daftar Tunggu Reservasi dan solusi pilihan untuk masalah tersebut.

  • Jika beberapa (tetapi tidak semua) jumlah tamu tidak menerima penambahan daftar tunggu baru karena tidak ada waktu tunggu untuk jumlah tamu tersebut, sebaiknya tampilkan WaitEstimates untuk semua jumlah tamu dalam respons BatchGetWaitEstimates dan izinkan pengguna untuk bergabung ke daftar tunggu untuk jumlah tamu tersebut tanpa menunggu. Menampilkan WaitLength dengan 0 parties_ahead_count dan/atau dengan estimated_seat_time_range dengan 0 start_seconds dan dengan 0 end_seconds untuk party_size tanpa menunggu
  • Jika satu atau beberapa jumlah tamu tidak menerima penambahan daftar tunggu baru karena waktu tunggunya terlalu lama, sebaiknya hapus WaitEstimates untuk jumlah tamu tersebut dalam respons BatchGetWaitEstimates.

Pendekatan ini lebih disarankan karena memberikan opsi kepada pengguna meskipun daftar tunggu penjual mungkin tidak sepenuhnya terbuka.

Panduan untuk partner khusus Daftar Tunggu Reservasi

Perhatikan hal-hal berikut jika server pemesanan hanya digunakan untuk daftar tunggu:

  • Partner khusus Daftar Tunggu Reservasi tidak menyediakan feed ketersediaan ke Pesan dengan Google.
  • Partner khusus Daftar Tunggu Reservasi tidak menerapkan metode reservasi di server pemesanan mereka. Sebagai gantinya, Anda dapat Menerapkan server pemesanan dengan petunjuk untuk penerapan Daftar Tunggu.
  • Partner khusus Daftar Tunggu Reservasi tidak melakukan panggilan API ke Google. Artinya, partner khusus Daftar Tunggu Reservasi tidak perlu menyiapkan project cloud atau memberikan alamat email developer. Anda tidak perlu menyelesaikan Update API real-time. Namun, feed penjual dan layanan tetap harus disediakan ke Pusat Tindakan.

Panduan untuk partner yang penjualnya harus menyetujui/menolak penambahan daftar tunggu secara manual

Jika penjual Anda memerlukan kemampuan untuk menyetujui atau menolak penambahan daftar tunggu baru dari Google secara manual, langkah-langkah tambahan diperlukan:

  • Tetapkan waitlist_confirmation_mode ke WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS di wait_estimate untuk jumlah tamu yang memerlukan konfirmasi manual. Ini harus ditetapkan di BatchGetWaitEstimateResponse dan GetWaitlistEntryResponse.
  • Entri daftar tunggu yang telah diminta oleh pengguna, tetapi belum diterima oleh penjual harus memiliki status PENDING_MERCHANT_CONFIRMATION.

Kasus pengujian Daftar Tunggu Pemesanan

Google menguji kasus penggunaan berikut untuk memastikan fungsi metode daftar tunggu dalam penerapan server pemesanan Anda. Google juga menguji dan memantau latensi. Semua pengujian ini harus dinyatakan lulus sebelum peluncuran dilakukan.

Pengambilan WaitEstimate

  • Estimasi waktu tunggu ditampilkan untuk setiap jumlah tamu yang diminta dalam BatchGetWaitEstimatesRequest.
  • Untuk jumlah tamu yang memiliki opsi bagi penjual untuk menerima atau menolak penambahan daftar tunggu baru, tetapkan queue_confirmation_mode ke WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS.

Pembuatan entri daftar tunggu

  • Entri daftar tunggu dapat dibuat dari permintaan CreateWaitlistEntry.
  • Jika pembuatan entri daftar tunggu gagal, error logika bisnis muncul dalam respons.
  • Jika percobaan CreateWaitlistEntry berhasil, respons yang sama akan ditampilkan saat CreateWaitlistEntry yang sama diterima lagi.
  • Jika percobaan CreateWaitlistEntry gagal, server akan mencoba kembali saat CreateWaitlistEntry yang sama diterima kembali.
  • Entri daftar tunggu muncul di antarmuka penjual.
  • Panggilan ke GetWaitlistEntry berhasil menampilkan entri daftar tunggu yang dibuat.

Status dan stempel waktu entri daftar tunggu

  • Pastikan setiap status entri daftar tunggu ditampilkan dengan benar dalam entri daftar tunggu dalam respons GetWaitlistEntry.
  • Pastikan setiap stempel waktu status ditetapkan di kolom stempel waktu yang sesuai dari entri daftar tunggu dalam respons GetWaitlistEntry.

Penghapusan entri daftar tunggu

  • Entri daftar tunggu yang ada dapat dihapus. Respons terhadap penghapusan yang berhasil harus berupa proto kosong {}.

Memilih tidak ikut

Contoh feed layanan daftar tunggu (JSON)

Feed layanan daftar tunggu

Pilihan tidak ikut penjual

Google mengharapkan respons tertentu untuk penjual yang sebelumnya telah mengaktifkan daftar tunggu, tetapi telah memutuskan untuk tidak ikut.

Pilihan tidak ikut langsung

Pilihan tidak ikut diperpanjang

  • Hapus waitlist_rules dari feed layanan untuk penjual jika penjual memilih untuk tidak ikut dalam reservasi.
  • Menghapus penjual dari feed penjual jika dia memilih tidak ikut semua integrasi Google.
Berikutnya
Langkah 1: Penyiapan