Ikhtisar

Partner yang berpartisipasi dalam program Daftar Tunggu Reservasi harus menyelesaikan Penyiapan akun sebelum memulai. Namun, beberapa langkah dalam panduan umum tidak diperlukan untuk penggunaan fitur daftar tunggu. Panduan di halaman ini menjelaskan langkah-langkah yang berlaku untuk partner yang berminat 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 didukung fitur daftar tunggu di Pusat Actions.

Secara keseluruhan, alur data utama antara Anda (Partner) dan Google diilustrasikan dalam Gambar 2:

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 memiliki waitlist_rules yang 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 pembaruan SMS diperlukan untuk penerapan daftar tunggu dalam kasus berikut:
  • Untuk mengonfirmasi bahwa pengguna telah berhasil bergabung ke daftar tunggu.
  • Untuk memberi tahu pengguna bahwa meja 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 menyediakan feed ketersediaan ke Pusat Tindakan.
• 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 Action menjalankan kumpulan kasus pengujian untuk metode daftar tunggu di server pemesanan.

Diagram alir status

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

Kasus ekstrem umum

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

• Jika beberapa (tetapi tidak semua) jumlah tamu tidak menerima penambahan daftar tunggu baru karena tidak ada waktu tunggu dengan jumlah tamu tersebut, sebaiknya tampilkan WaitEstimates untuk semua jumlah tamu dalam respons BatchGetWaitEstimates dan izinkan pengguna bergabung ke daftar tunggu untuk jumlah tamu tersebut tanpa waktu tunggu. 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 tunggu menjadi 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 Pemesanan

Perhatikan 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 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 tambahan diperlukan:

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

Kasus pengujian Daftar Tunggu Reservasi

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 memberikan opsi bagi penjual untuk menerima atau menolak penambahan daftar tunggu baru, tetapkan waitlist_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 akan muncul dalam respons.
• Jika percobaan CreateWaitlistEntry berhasil, respons yang sama ditampilkan saat CreateWaitlistEntry yang sama diterima kembali.
• Jika percobaan CreateWaitlistEntry gagal, server akan mencoba lagi 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

• Verifikasi bahwa setiap status entri daftar tunggu ditampilkan dengan benar dalam entri daftar tunggu dalam respons GetWaitlistEntry.
• Verifikasi bahwa setiap stempel waktu status ditetapkan di kolom stempel waktu yang sesuai di 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 {}.

Nonaktifkan

• Verifikasikan bahwa penjual yang tidak ikut serta ditangani seperti yang dideskripsikan dalam Ketidakikutsertaan penjual.

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

Pilihan tidak ikut langsung

• Menampilkan CLOSED_OTHER untuk permintaan BatchGetWaitEstimates.
• Menampilkan WAITLIST_CLOSED untuk permintaan CreateWaitlistEntry.
• Menampilkan permintaan GetWaitlistEntry dengan benar untuk pengguna yang sudah ada dalam daftar tunggu.

Pilihan tidak ikut diperpanjang

• Hapus waitlist_rules dari feed layanan untuk penjual jika penjual memilih menggunakan reservasi.
• Menghapus penjual dari feed penjual jika mereka memilih tidak melakukan semua integrasi Google.