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](https://developers-dot-devsite-v2-prod.appspot.com/static/actions-center/images/waitlists/reserve_with_google_waitlist_integration.png?authuser=7&hl=id)
Secara keseluruhan, aliran data utama antara Anda (Partner) dan Google digambarkan pada Gambar 2:
![Gambar 2: Diagram alur data integrasi](https://developers-dot-devsite-v2-prod.appspot.com/static/actions-center/images/waitlists/waitlist_integration_data_flow_diagram.png?authuser=7&hl=id)
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](https://developers-dot-devsite-v2-prod.appspot.com/static/actions-center/images/waitlists/waitlist_status_flowchart.png?authuser=7&hl=id)
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 responsBatchGetWaitEstimates
dan izinkan pengguna untuk bergabung ke daftar tunggu untuk jumlah tamu tersebut tanpa menunggu. MenampilkanWaitLength
dengan 0parties_ahead_count
dan/atau denganestimated_seat_time_range
dengan 0start_seconds
dan dengan 0end_seconds
untukparty_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 responsBatchGetWaitEstimates
.
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
keWAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS
diwait_estimate
untuk jumlah tamu yang memerlukan konfirmasi manual. Ini harus ditetapkan diBatchGetWaitEstimateResponse
danGetWaitlistEntryResponse
. - 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 saatCreateWaitlistEntry
yang sama diterima lagi. - Jika percobaan
CreateWaitlistEntry
gagal, server akan mencoba kembali saatCreateWaitlistEntry
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
- Pastikan penjual yang tidak ikut serta diperlakukan seperti yang dijelaskan dalam Ketidakikutsertaan penjual.
Contoh feed layanan daftar tunggu (JSON)
Feed layanan daftar tungguPilihan 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
- Tampilkan
CLOSED_OTHER
untuk permintaanBatchGetWaitEstimates
. - Tampilkan
WAITLIST_CLOSED
untuk permintaanCreateWaitlistEntry
. - Tampilkan
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 untuk tidak ikut dalam reservasi. - Menghapus penjual dari feed penjual jika dia memilih tidak ikut semua integrasi Google.