Bagian ini memberikan detail lebih lanjut tentang 3 bagian utama dari integrasi dengan Actions Center. Anda akan menggunakan setiap bagian tersebut dalam langkah-langkah yang dijelaskan dalam panduan Integrasi Menyeluruh.
Feed
Feed
adalah file dalam format JSON atau
pb3 yang digunakan untuk
mengirimkan data inventaris Anda ke Actions Center. Hal ini memungkinkan Anda
mengirimkan semua data sekaligus untuk memperbarui slot penjual, layanan, dan
slot ketersediaan menggunakan upload SFTP.
Maps Booking API
Maps Booking API memungkinkan Anda memperbarui objek di sistem Actions Center di antara sejumlah pengiriman feed untuk terus memperbarui informasi. API ini juga memungkinkan Anda membatalkan pemesanan yang dilakukan melalui Pesan dengan Google integrasi menyeluruh.
Update Real Time diimplementasikan menggunakan panggilan REST.
Booking Server
Agar integrasi menyeluruh Actions Center dapat membuat pemesanan atas nama Anda, Anda harus menyiapkan Server Pemesanan.
REST API
Versi v3 adalah API versi terbaru, dan mendukung antarmuka berbasis REST. Semua integrasi baru harus menggunakan API v3.
Bagian ini menentukan file feed yang digunakan untuk mengirimkan data inventaris Anda ke Actions Center. Konten feed Anda menentukan layanan mana saja yang Anda berikan, layanan apa saja 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 Google Maps Booking API.
Feed berikut wajib ada di seluruh integrasi:
- Feed penjual: Berisi data yang mendeskripsikan penjual Anda.
Selain itu, 2 feed berikut wajib ada untuk integrasi menyeluruh.
- Feed layanan: Mendeskripsikan 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 dihapus dari feed jika kosong.
Format feed dideskripsikan menggunakan sintaksis protocol buffer 3. Anda memiliki opsi untuk mengupload file feed sebagai serialisasi biner data protocol buffer dalam format pb3 atau dalam format JSON turunan. Sebaiknya upload feed dalam format JSON.
Sebaiknya gunakan gzip untuk mengompresi feed sebelum diupload.
Panduan ini ditujukan khusus untuk protocol buffer Actions Center. Untuk mendapatkan informasi umum tentang cara menggunakan protocol buffer guna menghasilkan file pb3 file, berikut adalah contoh di Java.