Melakukan autentikasi dengan Mapsbooking API

Untuk melakukan pembaruan 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. Mengaktifkan Maps Booking API di project GCP Anda
4. Men-debug masalah umum

Untuk mengetahui informasi tentang cara membuat permintaan ke API, lihat bagian pembaruan API real-time di panduan Penawaran.

Menyiapkan project Google Cloud dengan Actions Center

Catatan: Jika 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 Actions Center Anda.

1. Login ke akun Google Cloud Platform Anda.
2. Anda dapat membuat project baru atau menggunakan project yang sudah 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 Tugas Onboarding Partner Portal dengan mengirimkan nomor project cloud dan alamat email project cloud (email yang digunakan untuk mengelola project cloud).

Membuat Akun Layanan dan kredensial OAuth

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

1. Login kembali ke akun Google Cloud Platform Anda.
2. Buka IAM & admin > Akun layanan.
3. Cari ID 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 cukup untuk menggunakannya ditentukan oleh pengaitan nomor project Anda dalam konfigurasi Actions Center. Jika Anda tidak yakin peran mana yang akan dipilih, pilih Project > Viewer.
7. Setelah mengklik “continue” 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 nanti.
9. Login kembali ke Partner Portal dan selesaikan tugas yang tersisa di halaman Tugas Onboarding Partner Portal.

Mengaktifkan MapsBooking API

1. Login ke akun Google Cloud Platform Anda.
2. Buka API & Layanan > Dasbor.
3. Klik Aktifkan API dan Layanan, lalu cari Google Maps Booking API.
4. Aktifkan API berikut:
   • Google Maps Booking API
   • Google Maps Booking API (Dev)

Catatan: Jika Anda telah menyelesaikan langkah-langkah onboarding dan ingin mengupdate project cloud yang ada ke project cloud 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 Pembaruan Real-Time, lihat bagian pembaruan API real-time di panduan Penawaran. Anda juga dapat menemukan klien contoh dalam beberapa bahasa di bagian Contoh Kode.

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

1. Gunakan Library Klien Google.
2. Buat Kredensial OAuth menggunakan Otorisasi Akun Layanan.
3. Beri 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 mengotorisasi permintaan kredensial OAuth dengan benar:

1. Anda memberi 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 Actions Center Anda dengan informasi berikut:

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