Mengautentikasi dengan Maps Booking API

Untuk melakukan update real-time, Anda harus membuat permintaan ke Maps Booking API. Maps Booking API mengharuskan Anda mengautentikasi permintaan melalui OAuth 2.0 menggunakan akun layanan GCP yang memiliki akses ke API, dan telah dialokasikan QPS yang diperlukan. Panduan ini akan memandu Anda melalui langkah-langkah untuk:

1. Menyiapkan project Google Cloud
2. Membuat akun layanan
3. Aktifkan Maps Booking API di project GCP Anda
4. Men-debug masalah umum

Untuk mengetahui informasi tentang cara membuat permintaan ke API, lihat bagian update API real-time dalam panduan Penawaran Reservasi.

Menyiapkan project Google Cloud dengan Pusat Tindakan

Catatan: Jika Anda telah menyiapkan akun Partner Portal, Anda harus menggunakan project Google Cloud yang dimasukkan sebagai bagian dari penyiapan. Jika Anda tidak lagi memiliki akses ke project Google Cloud Platform tersebut, atau memerlukan bantuan untuk mengidentifikasinya, hubungi kontak Pusat Tindakan Anda.

1. Login ke akun Google Cloud Platform Anda.
2. Anda dapat membuat project baru atau menggunakan project yang ada untuk tujuan ini.
   • Catat nomor project cloud karena Anda akan memerlukannya pada langkah berikutnya. Nomor project cloud Anda juga dapat ditemukan di Halaman Beranda Google Cloud Platform. Nomor project cloud selalu berupa angka saja.
3. Login ke Partner Portal.
4. Selesaikan langkah 1 di halaman Onboarding Tasks pada Partner Portal dengan mengirimkan nomor project cloud dan alamat email project cloud (alamat email yang digunakan untuk mengelola project cloud).

Membuat kredensial OAuth dan Akun Layanan

Catatan: Langkah-langkah ini harus dilakukan oleh akun dengan email developer yang dimasukkan di langkah-langkah tugas aktivasi.

1. Login kembali ke akun Google Cloud Platform Anda.
2. Buka IAM & admin > Service accounts.
3. Telusuri project cloud yang sudah ada atau yang baru dibuat.
4. Buat akun layanan.
5. Isi detail akun layanan.
6. Tetapkan peran yang paling sesuai dengan kebutuhan aplikasi Anda ke akun layanan baru. Pilihan peran untuk akun layanan tidak akan memengaruhi panggilan yang dapat dilakukan ke Google Maps Booking API, karena alokasi kuota yang memadai untuk menggunakannya ditentukan oleh pengaitan nomor project Anda dalam konfigurasi Pusat Tindakan. Jika Anda tidak yakin peran apa yang harus dipilih, cukup pilih Project > Viewer.
7. Setelah mengklik “lanjutkan” di langkah (6), Anda akan diberi opsi untuk membuat kunci JSON.
8. Simpan kredensial json. Pastikan untuk menyimpannya di tempat yang aman, karena Anda tidak akan dapat mengambilnya di lain waktu.
9. Login kembali ke Partner Portal dan selesaikan tugas yang tersisa di halaman Tugas Aktivasi di Partner Portal.

Mengaktifkan MapsBooking API

1. Login ke akun Google Cloud Platform Anda.
2. Buka API & Services > Dashboard.
3. Klik Enable APIs and Services, lalu telusuri Google Maps Booking API.
4. Aktifkan API berikut:
   • Google Maps Booking API
   • Google Maps Booking API (Dev)

Catatan: Jika Anda telah menyelesaikan langkah-langkah aktivasi dan ingin memperbarui project cloud yang ada ke project baru, hubungi kontak Actions Center Anda.

Kesalahan Umum

Ada berbagai alasan mengapa Anda mungkin mengalami masalah otorisasi saat membuat permintaan Pembaruan Real-Time. Jika Anda memerlukan panduan umum tentang cara membuat permintaan Update Real-Time, lihat bagian update API real-time dalam panduan Penawaran Pemesanan. Anda juga dapat menemukan contoh klien dalam beberapa bahasa di bagian Contoh Kode.

Jika Anda mengalami error 403, pastikan Anda memenuhi semua persyaratan berikut:

1. Gunakan Google Client Library.
2. Buat Kredensial OAuth menggunakan Autentikasi Akun Layanan.
3. Lakukan otorisasi terhadap cakupan yang sesuai.
4. Lakukan panggilan ke endpoint yang sesuai (tercantum di bawah).

Pastikan Anda melakukan panggilan ke endpoint yang benar:

1. Sandbox: https://partnerdev-mapsbooking.googleapis.com/v1alpha/...
2. Produksi: https://mapsbooking.googleapis.com/v1alpha/...

Pastikan Anda mengizinkan permintaan kredensial OAuth dengan benar:

1. Anda memberikan otorisasi terhadap cakupan "https://www.googleapis.com/auth/mapsbooking".
2. Anda menggunakan kunci akun layanan yang dibuat di Membuat Akun Layanan dan Kredensial OAuth.

Masih melihat error?

Jika Anda masih melihat error setelah mengikuti langkah-langkah ini, hubungi kontak Pusat Tindakan Anda dengan informasi berikut:

• Nomor project Cloud dan project ID dengan screenshot
• ID akun layanan
• Email yang digunakan untuk membuat akun layanan
• Detail endpoint yang mencoba membuat permintaan ke
• Waktu percobaan permintaan
• Pesan error dan permintaan lengkap yang diterima saat membuat permintaan.