Bagian ini memberikan detail selengkapnya tentang 3 bagian utama integrasi dengan Pusat Tindakan. Anda akan menggunakan setiap bagian tersebut dalam langkah-langkah yang diuraikan dalam Panduan Menyeluruh.
Feed
Feed adalah file dalam format JSON atau pb3 yang digunakan untuk mengirimkan data inventaris Anda ke Actions Center. Dengan begitu, Anda dapat mengirimkan semua data sekaligus untuk memperbarui slot ketersediaan penjual, layanan, dan slot ketersediaan menggunakan upload SFTP.
Maps Booking API
Maps Booking API memungkinkan Anda memperbarui objek di sistem Pusat Tindakan di antara pengiriman feed untuk memperbarui informasi. API ini juga memungkinkan Anda membatalkan pemesanan yang dilakukan melalui integrasi menyeluruh Pesan dengan Google.
Update Real Time diimplementasikan menggunakan panggilan REST.
Server Pemesanan
Agar integrasi menyeluruh Pusat Action dapat membuat pemesanan untuk Anda, Anda harus menyiapkan server Pemesanan.
REST API
Versi v3 adalah versi terbaru API, dan mendukung antarmuka berbasis REST. Semua integrasi baru harus menggunakan API v3.
Bagian ini menentukan file feed yang digunakan untuk mengirimkan data inventaris ke Pusat Tindakan. Konten feed Anda menentukan layanan yang Anda sediakan, layanan apa yang tersedia, dan kapan layanan tersebut tersedia.
Lihat akordeon Referensi dan Contoh untuk mempelajari cara membagikan feed ini kepada kami.
Struktur feed inventaris ditentukan oleh Booking API Google Maps.
Feed berikut bersifat wajib di seluruh integrasi:
- Feed penjual: Berisi data yang mendeskripsikan penjual Anda.
Selain itu, 2 feed berikut bersifat wajib untuk integrasi menyeluruh.
- Feed layanan: Menjelaskan layanan yang disediakan oleh penjual Anda.
- Feed ketersediaan: Mencantumkan slot ketersediaan layanan yang disediakan oleh penjual Anda.
Beberapa kolom dalam feed ini wajib diisi dan beberapa lainnya bersifat opsional. Kolom apa pun yang ditandai sebagai opsional dapat dihilangkan dari feed jika kosong.
Format feed dideskripsikan menggunakan sintaksis protocol buffer 3. Anda memiliki opsi untuk mengupload file feed sebagai serialisasi biner data buffering protokol dalam format pb3 atau dalam format JSON turunan. Sebaiknya upload feed dalam format JSON.
Sebaiknya gunakan gzip untuk mengompresi feed sebelum diupload.
Panduan ini khusus untuk buffering protokol Actions Center. Untuk informasi umum tentang cara menggunakan buffering protokol untuk menghasilkan file pb3, berikut adalah contoh di Java.