Mengautentikasi dengan Maps Booking API

Untuk melakukan pembaruan real-time, Anda perlu 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 informasi tentang cara membuat permintaan ke API, lihat bagian update API real-time di panduan Janji Temu Menyeluruh.

Menyiapkan project Google Cloud dengan Actions Center

  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 Utama Google Cloud Platform. Nomor project cloud selalu berupa angka saja.
  3. Login ke Portal Partner.
  4. Selesaikan langkah 1 di halaman Tugas Orientasi di Partner Portal dengan mengirimkan nomor project cloud dan alamat email project cloud (alamat email yang digunakan untuk mengelola project cloud).

Membuat kredensial Akun Layanan dan OAuth

  1. Login kembali ke akun Google Cloud Platform Anda.
  2. Buka IAM & admin > Service accounts.
  3. Telusuri 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 untuk 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 Actions Center. 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 Portal Partner dan selesaikan tugas yang tersisa di halaman Tugas Orientasi di Portal Partner.

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)

Kesalahan Umum

Ada berbagai alasan yang dapat menyebabkan Anda mengalami masalah otorisasi saat membuat permintaan Update Real-Time. Jika Anda memerlukan panduan umum tentang cara membuat permintaan Update Real-Time, lihat bagian update API real-time dalam panduan Janji Temu Lengkap. Anda juga dapat menemukan contoh klien dalam beberapa bahasa di bagian Contoh Kode.

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

  1. Gunakan Library Klien Google.
  2. Buat Kredensial OAuth menggunakan Autentikasi 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 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 kredensial Akun Layanan dan OAuth.

Masih melihat error?

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

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