Server Pemesanan Siap

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

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

Selesaikan tugas Siap Server Pemesanan berikut sebelum Anda beralih ke Pembaruan Real-Time:

Setiap tugas akan ditandai selesai dan berubah menjadi hijau saat Anda mengirim detail inventaris real-time yang akurat ke permintaan Server Pemesanan melalui alur pemesanan Sandbox. Milestone 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 sepenuhnya diuji.

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 HealthCheck permintaan 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 pengujian server SSL 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.

Membuat 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 mencantumkan 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 pemuatan halaman.

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 untuk ditampilkan. POST /v3/BatchAvailabilityLookup/
Klik slot BatchAvailabilityLookup Saat pengguna melihat slot yang tersedia untuk pemesanan dan mengklik a slot, permintaan BatchAvailabilityLookup akan dipanggil untuk klik slot. Respons harus menunjukkan ketersediaan slot saat ini yang sebenarnya. slot. Jika slot sudah dipesan sebelum klik slot, 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 the CreateBooking respons dipanggil.

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

 POST /v3/CreateBooking/
UpdateBooking Setelah pemesanan dilakukan melalui Reservasi 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 Actions Center 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/

Kriteria milestone

Untuk menyelesaikan milestone Siap Server Pemesanan, integrasi Anda harus memenuhi kriteria berikut di lingkungan Sandbox dan Produksi:

Metode Jumlah Permintaan yang Diperlukan (Sandbox) Jumlah Permintaan yang Diperlukan (Produksi) Tingkat Keberhasilan yang Diperlukan
Pemuatan halaman BatchAvailabilityLookup 20 20 90%
Klik slot BatchAvailabilityLookup 20 20 90%
CreateBooking 10 3 90%
UpdateBooking 10 3 90%

Alur pemesanan Sandbox

Untuk melihat alur pemesanan Sandbox, buka tampilan Actions Center Inventaris. Kolom RwG - E2E pada tampilan Inventaris menampilkan link Live (in 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, tindakan ini akan memicu permintaan BatchAvailabilityLookup saat pemuatan halaman dan menampilkan ketersediaan penjual yang diketahui.

  • Saat Anda mengklik waktu reservasi, tindakan ini akan memicu permintaan BatchAvailabilityLookup saat klik slot dan menampilkan modal pemesanan.

  • Selesaikan pemesanan dengan modal pemesanan untuk mengirim permintaan CreateBooking.

  • Setelah Anda menyelesaikan pemesanan di lingkungan Sandbox, akun yang digunakan untuk membuat pemesanan akan menerima konfirmasi email 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.