Inventaris dalam sistem Anda berubah karena pemesanan baru, pembatalan, dan perubahan jadwal dari penjual Anda. Real-Time Update (RTU) API adalah mekanisme untuk memberi tahu Google tentang perubahan ini, dan perubahan yang dilakukan pada pemesanan yang ada.
RTU diperlukan dalam kasus berikut:
- Saat pengguna membatalkan reservasi di sistem Anda, dan slot menjadi tersedia.
- Saat pengguna memesan reservasi melalui Pusat Tindakan, dan slot tidak lagi tersedia.
- Jika reservasi yang dilakukan melalui Actions Center dibatalkan di sisi Anda. Contoh situasi mencakup pembatalan oleh penjual secara langsung. Anda perlu memperbarui pemesanan dan ketersediaan karena slot asli sekarang tersedia.
Selesaikan tugas pencapaian RTU berikut sebelum Anda beralih ke peninjauan Sandbox:
Setiap tugas ditandai selesai dan berubah menjadi hijau jika 20 permintaan terakhir tidak menimbulkan error selama 14 hari. Terus kirim permintaan yang berhasil untuk memastikan tonggak pencapaian tetap berwarna hijau.
API RTU dan Feed
RTU API memberi tahu Google tentang perubahan bertahap pada ketersediaan inventaris dan pemesanan secara real-time. Selain RTU, kirim Feed Ketersediaan lengkap setiap hari. Tindakan ini memastikan bahwa Google memiliki informasi ketersediaan yang paling akurat dan terbaru sebagaimana yang ada di sistem Anda. Feed Lengkap berfungsi sebagai snapshot status ketersediaan inventaris terbaru di sistem Anda.
Untuk informasi selengkapnya, lihat referensi berikut:
Mengakses API
Project Google Cloud Anda adalah cara Anda mengakses Maps Booking API Actions Center, yang merupakan cara Anda mengirimkan RTU. Anda harus menggunakan Akun Google dalam konsol Google Developer dan memberikan Nomor Project Cloud Anda di tonggak pencapaian Penyiapan dalam rencana aktivasi Anda. Untuk mengetahui informasi selengkapnya tentang cara mengaktifkan Cloud API, lihat Mengaktifkan Cloud API.
Menggunakan panggilan RESTful atau mendownload library klien
Sebaiknya lakukan panggilan RESTful langsung ke Maps Booking API dengan payload JSON. Untuk mengetahui informasi selengkapnya, lihat dokumentasi REST API.
Anda juga dapat menggunakan library klien untuk terhubung ke API.
.| Language | Link download |
|---|---|
| Java | Library klien Java. Untuk mengetahui informasi selengkapnya, lihat petunjuk klien Java. |
Support library tambahan yang menangani otorisasi dan aspek panggilan lainnya ke Google API tersedia untuk didownload. Untuk mengetahui informasi selengkapnya, lihat Contoh Kode.
Mengambil dokumen Discovery
Untuk beberapa library klien, seperti Ruby, Anda perlu mengambil dokumen Discovery untuk API yang mendeskripsikan metode dan parameternya.
Untuk mengambil dokumen Discovery, gunakan perintah berikut:
curl -s -o mapsbooking_rest
https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha
Untuk mengetahui informasi selengkapnya tentang cara mengakses API dari Ruby, lihat Klien API Ruby dan Library Autentikasi Ruby.
Melakukan panggilan yang diotorisasi ke API
Saat Anda melakukan panggilan ke API, lihat Mempersiapkan untuk melakukan panggilan API yang didelegasikan guna mengotorisasi akun layanan Anda dengan kunci pribadi Anda dan cakupan OAuth berikut:
https://www.googleapis.com/auth/mapsbooking
Endpoint Sandbox dan Produksi
Anda dapat melakukan panggilan ke lingkungan Sandbox dan Produksi melalui API. Pastikan Anda mengaktifkan kedua API tersebut di project Google Cloud Anda. Kedua API menggunakan cakupan yang sama, tetapi memiliki endpoint yang berbeda.
Endpoint produksi: https://mapsbooking.googleapis.com/
Endpoint sandbox: https://partnerdev-mapsbooking.googleapis.com/
Berikut adalah contoh di Java tentang cara beralih endpoint:
// This block of code is for OAuth and is the same for prod and sandbox.
GoogleCredential
.fromStream(new FileInputStream(...))
.createScoped(Collections.singleton("https://www.googleapis.com/auth/mapsbooking"))
// This block of code sets the endpoint. This is what you'd change to connect to the sandbox.
new GoogleMapsBookingAPI.Builder(...)
.setApplicationName(...)
.setRootUrl("https://partnerdev-mapsbooking.googleapis.com/") // you add this to change the endpoint to use partnerdev.
.build()