Bagian ini memberikan detail selengkapnya 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 Pusat Tindakan. Hal ini memungkinkan Anda
mengirimkan semua data sekaligus untuk memperbarui slot penjual, layanan, dan
ketersediaan menggunakan upload SFTP.
Maps Booking API
Maps Booking API memungkinkan Anda memperbarui objek di sistem Pusat Tindakan di antara sejumlah pengiriman feed untuk terus memperbarui informasi. API ini juga memungkinkan Anda membatalkan pemesanan yang dilakukan melalui integrasi menyeluruh Pesan dengan Google.
Update Real-Time diterapkan menggunakan panggilan REST.
Booking Server
Agar integrasi menyeluruh Pusat Actions 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 semua integrasi:
- Feed penjual: Berisi data yang mendeskripsikan penjual Anda.
Selain itu, 2 feed berikut bersifat wajib 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 buffer protokol dalam format pb3 atau dalam format JSON turunan. Sebaiknya upload feed dalam format JSON.
Sebaiknya gunakan gzip untuk mengompresi feed sebelum mengupload.
Panduan ini ditujukan khusus untuk buffer protokol Actions Center. Untuk informasi umum tentang cara menggunakan protocol buffer guna menghasilkan file pb3, berikut adalah contoh di Java.