Pengantar tentang daftar tunggu

Partner yang berpartisipasi dalam program daftar tunggu 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 tertarik menggunakan fitur daftar tunggu di Pesan dengan Google. Sebaiknya Anda membaca ringkasan ini sebelum melakukan langkah-langkah integrasi.

Proses peluncuran

Gambar 1 menguraikan proses untuk meluncurkan penjual yang mengaktifkan daftar tunggu Anda di Pesan dengan Google.

Gambar 1: Langkah integrasi tingkat tinggi
Gambar 1: Langkah-langkah integrasi tingkat tinggi

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

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

Panduan untuk semua partner daftar tunggu

Perhatikan hal-hal berikut saat Anda menerapkan fitur daftar tunggu:

  • Layanan untuk setiap penjual daftar tunggu 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.
  • Mengirim update 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 tunggu mereka 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 Pesan dengan Google.
  • 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.
  • Pesan dengan Google menjalankan serangkaian 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 juga menunjukkan kapan harus merekam dan mengisi kolom WaitlistEntry.waitlist_entry_state_times.*_time_seconds serta kapan harus mengirim SMS kepada pengguna untuk memberi tahu bahwa mereka telah memasuki status baru.

Gambar 3: Diagram alir status daftar tunggu
Gambar: 3 Diagram alir status daftar tunggu

Kasus ekstrem umum

Berikut adalah kasus ekstrem umum dalam integrasi daftar tunggu 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

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

  • Partner khusus daftar tunggu tidak menyediakan feed ketersediaan untuk Pesan dengan Google.
  • Partner khusus daftar tunggu 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 tidak melakukan panggilan API ke Google. Ini berarti partner khusus daftar tunggu 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 diberikan untuk Pesan dengan Google.

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. Ini harus ditetapkan di BatchGetWaitEstimateResponse dan GetWaitlistEntryResponse.
  • Entri daftar tunggu yang telah diminta oleh pengguna, tetapi belum disetujui oleh penjual harus berstatus PENDING_MERCHANT_CONFIRMATION.

Kasus uji daftar tunggu

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 diberi opsi oleh penjual untuk menerima atau menolak penambahan daftar tunggu baru, tetapkan daftar tunggu_konfirmasi_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 upaya CreateWaitlistEntry berhasil, respons yang sama akan ditampilkan saat CreateWaitlistEntry yang sama diterima lagi.
  • Jika upaya 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

  • Pastikan setiap status entri daftar tunggu ditampilkan dengan benar dalam entri daftar tunggu untuk respons GetWaitlistEntry.
  • Pastikan 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 {}.

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

Pilihan tidak ikut langsung

Pilihan tidak ikut diperpanjang

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