Server Pemesanan Siap

Anda memerlukan Server Pemesanan agar Actions Center dapat melakukan panggilan balik untuk membuat dan memperbarui pemesanan atas nama Anda. Hal ini memungkinkan Actions Center membuat janji temu, pemesanan, dan reservasi dengan bisnis Anda atas nama pengguna.

Untuk mempelajari cara mengonfigurasi koneksi ke Server Pemesanan Sandbox dan Produksi, lihat Mengonfigurasi Kredensial Server Pemesanan.

Selesaikan tugas Booking Server Ready berikut sebelum Anda beralih ke Pembaruan Real-Time:

Setiap tugas ditandai selesai dan berubah menjadi hijau saat Anda mengirimkan detail inventaris real-time yang akurat ke permintaan Server Pemesanan melalui alur pemesanan Sandbox. Tonggak pencapaian Server Pemesanan dianalisis selama periode 14 hari.

Menerapkan antarmuka REST API

Menerapkan antarmuka API berdasarkan REST. Hal ini memungkinkan Google mengirimkan permintaan Server Pemesanan melalui HTTPS.

Untuk menerapkan antarmuka API, siapkan Server Pemesanan pengembangan atau Sandbox yang terhubung ke lingkungan Sandbox Actions Center. Beralihlah ke lingkungan Produksi hanya setelah server Sandbox diuji sepenuhnya.

Semua permintaan Server Pemesanan Google berhubungan dengan URL Server Pemesanan yang ditetapkan di halaman Server Pemesanan. Misalnya, jika URL Anda ditetapkan ke api.example.com/google, semua permintaan HealthCheck akan dikirim ke api.example.com/google/v3/HealthCheck.

Pastikan endpoint Server Pemesanan yang benar dikonfigurasi untuk lingkungan Sandbox dan Produksi dengan pengalih lingkungan.

Keamanan dan autentikasi

Semua komunikasi ke Server Pemesanan Anda dilakukan melalui HTTPS menggunakan autentikasi dasar. Untuk membantu menyiapkan server Anda, sebaiknya gunakan alat verifikasi SSL atau TLS yang tersedia secara publik, seperti SSL server test dari Qualys.

Semua permintaan yang dibuat Google ke Server Pemesanan Anda diautentikasi dengan autentikasi dasar HTTPS. Anda dapat memasukkan informasi autentikasi dasar, sandi, dan nama pengguna Server Pemesanan di halaman konfigurasi Server Pemesanan Actions Center. Kredensial harus diubah setiap enam bulan.

Membangun Server Pemesanan

Server Pemesanan menentukan cara integrasi berkomunikasi dengan sistem Anda, dan membuat atau memperbarui pemesanan. Untuk mengonfigurasi koneksi ke Server Pemesanan Sandbox dan Produksi, lihat Mengonfigurasi Kredensial Server Pemesanan.

Setiap respons yang dibuat Server Pemesanan Anda terhadap permintaan dari Pesan dengan Google diharapkan berisi detail inventaris real-time yang akurat. Tabel berikut menunjukkan metode untuk setiap penerapan, dan menyertakan link ke format protokol layanan:

Metode Definisi Respons Permintaan HTTP
Pemuatan halaman BatchAvailabilityLookup

Saat pengguna mengklik Pesan Meja untuk penjual Anda, permintaan BatchAvailabilityLookup akan dipanggil saat halaman dimuat.

Payload berisi banyak slot yang didasarkan pada upload Feed terbaru Anda, yang dianggap tersedia oleh Reservasi dengan Google.

 Respons harus menyertakan setiap permintaan slot dan ketersediaan slot saat ini. Hal ini mencegah slot yang tidak tersedia ditampilkan. POST /v3/BatchAvailabilityLookup/
BatchAvailabilityLookup klik slot Saat pengguna melihat slot yang tersedia untuk pemesanan dan mengklik slot, permintaan BatchAvailabilityLookup akan dipanggil untuk klik slot. Respons harus menunjukkan ketersediaan slot yang sebenarnya saat ini. Jika sudah dipesan sebelum slot diklik, tampilkan respons bahwa slot tidak tersedia. POST /v3/BatchAvailabilityLookup/
CreateBooking Saat pengguna mengonfirmasi bahwa mereka ingin memesan slot waktu yang dipilih di modal pemesanan, permintaan CreateBooking akan dikirim.

Respons harus menunjukkan keberhasilan atau kegagalan pemesanan.

Jika pemesanan gagal, Anda harus menampilkan alasan spesifik kegagalan tersebut. Misalnya, slot sudah dipesan sebelum respons CreateBooking dipanggil.

Jika pemesanan berhasil dibuat, respons akan menyertakan booking_id unik untuk merujuk ke pemesanan dalam permintaan atau pembaruan di masa mendatang.

 POST /v3/CreateBooking/
UpdateBooking Setelah melakukan pemesanan melalui Pesan dengan Google, pengguna dapat memilih untuk mengubah pemesanan mereka. Saat pengguna memperbarui atau membatalkan reservasi, permintaan UpdateBooking akan dikirim. Seperti respons CreateBooking, respons Anda terhadap UpdateBooking harus menunjukkan keberhasilan pemesanan atau menampilkan alasan spesifik kegagalan. POST /v3/UpdateBooking/
HealthCheck Pusat Tindakan melakukan panggilan rutin ke Server Pemesanan Anda untuk mengonfirmasi bahwa infrastruktur Anda aktif dan berjalan.

Gunakan kode status HTTP untuk menunjukkan status penayangan server Anda. Tampilkan kode status HTTP 200 jika server aktif dan berjalan dengan baik.

Untuk menunjukkan error atau menonaktifkan integrasi Anda untuk sementara, tampilkan kode status HTTP non-2xx yang sesuai.

 GET /v3/HealthCheck/

Alur pemesanan Sandbox

Untuk melihat alur pemesanan Sandbox, buka tampilan Inventaris di Pusat Tindakan. Kolom RwG - E2E di tampilan Inventaris menampilkan link Live (di Sandbox) ke alur pemesanan Sandbox untuk penjual Sandbox yang cocok dan memiliki ketersediaan di masa mendatang.

Berikut adalah tindakan dalam alur pemesanan:

  • Saat Anda mengklik link RwG - E2E, permintaan BatchAvailabilityLookup akan dipicu saat halaman dimuat dan menampilkan ketersediaan penjual yang diketahui.
  • Saat Anda mengklik waktu reservasi, permintaan BatchAvailabilityLookup saat slot diklik akan dipicu dan modal pemesanan akan ditampilkan.
  • Selesaikan pemesanan dengan modal pemesanan untuk mengirim permintaan CreateBooking.
  • Setelah Anda menyelesaikan pemesanan di lingkungan Sandbox, akun yang digunakan untuk membuat pemesanan akan menerima email konfirmasi dengan detail pemesanan.
  • Untuk memicu metode UpdateBooking, ubah atau batalkan pemesanan dari email.

HealthCheck

Pastikan untuk menerapkan metode HealthCheck di Sandbox dan Produksi. Metode ini menampilkan status kondisi Server Pemesanan Anda. Hal ini memungkinkan Google terus memantau status penayangan Server Pemesanan Anda.

Permintaan: Tidak ada

Nilai yang ditampilkan: Tidak ada

Gunakan kode status HTTP untuk menunjukkan status penayangan server Anda.

Jika server aktif dan berjalan dengan baik, tampilkan kode status HTTP 200, atau untuk menunjukkan error, tampilkan salah satu kode status HTTP.