Mengautentikasi Maps Booking API

Untuk membuat pembaruan real-time, Anda harus mengajukan 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 informasi tentang cara membuat permintaan ke API, lihat bagian update API real-time dalam panduan menyeluruh.

Menyiapkan project Google Cloud Anda dengan Pesan dengan Google

Catatan: Jika sudah menyiapkan akun Portal Partner, 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 Pesan dengan Google 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 Portal Partner.
4. Selesaikan langkah 1 pada halaman Onboarding Tasks di Portal Partner 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 yang mencantumkan email developer yang dimasukkan dalam langkah-langkah tugas orientasi.

1. Login kembali ke akun Google Cloud Platform Anda.
2. Buka IAM & admin > Akun layanan.
3. Telusuri ID project cloud yang sudah ada atau yang baru dibuat.
4. Buat akun layanan.
5. Isi detail akun layanan.
6. Tetapkan peran pada akun layanan baru yang paling sesuai dengan kebutuhan aplikasi Anda. Pilihan peran untuk akun layanan tidak akan berpengaruh pada panggilan apa yang dapat dilakukan ke Google Maps Booking API, karena alokasi kuota yang memadai untuk menggunakannya akan ditentukan oleh pengaitan nomor project Anda di konfigurasi Pesan dengan Google. Jika Anda tidak yakin peran apa yang harus dipilih, cukup pilih Project > Viewer.
7. Setelah mengklik “lanjutkan” pada 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 Portal Partner dan selesaikan tugas yang tersisa di halaman Orientasi Tugas Portal Partner.

Mengaktifkan MapsBooking API

1. Login ke akun Google Cloud Platform Anda.
2. Buka API & Layanan > Dasbor.
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 orientasi dan ingin memperbarui project cloud yang ada dengan project baru, harap hubungi kontak Pesan dengan Google 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 dari panduan menyeluruh. Anda juga dapat menemukan klien contoh dalam beberapa bahasa di bagian Contoh Kode.

Jika Anda mengalami error 403, pastikan bahwa Anda mengikuti semua persyaratan berikut:

1. Gunakan Library Klien Google.
2. Buat Kredensial OAuth menggunakan Autentikasi Akun Layanan.
3. Memberikan 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 memberi otorisasi 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 Pesan dengan Google Anda dengan menyertakan informasi berikut:

• ID project dan nomor project cloud dengan screenshot
• ID akun layanan
• Email yang digunakan untuk membuat akun layanan
• Detail titik akhir berupaya membuat permintaan ke
• Waktu upaya permintaan
• Pesan error dan permintaan lengkap diterima saat membuat permintaan.