Menyiapkan dan menggunakan OAuth

Semua panggilan Local Services API harus diotorisasi melalui OAuth 2.0. Hal ini memungkinkan aplikasi klien Local Services API Anda mengakses akun Iklan Jasa dan Servis pengguna tanpa perlu menangani atau menyimpan informasi login pengguna.

Local Services API menggunakan protokol OAuth 2.0 untuk mengautentikasi pengguna. Untuk mempelajari OAuth 2.0 lebih lanjut, lihat Menggunakan OAuth 2.0 untuk Mengakses Google API.

Mengonfigurasi Project Konsol API Google untuk Local Services API

Untuk mengautentikasi dan memberi otorisasi pengguna Google Ads, Anda harus memiliki kredensial untuk mengakses server OAuth 2.0 Google. Kredensial ini mengidentifikasi aplikasi Anda ke Google dan memungkinkan Anda membuat token OAuth untuk mengelola pengguna Google Ads. Gunakan Konsol API Google untuk mengelola akses ke kredensial Google OAuth 2.0 Anda.

Untuk menerima kredensial ini, lakukan langkah-langkah berikut:

  1. Membuat project. Untuk melakukannya, buka Konsol API Google. Klik Buat project, masukkan nama, lalu klik Buat.

  2. Aktifkan Local Services API di project Anda:

    1. Buka API Library di Konsol API Google. Jika diminta, pilih project Anda atau buat project baru. Library API mencantumkan semua API yang tersedia, yang dikelompokkan berdasarkan kelompok produk dan popularitas.

      Jika Local Services API tidak terlihat dalam daftar, gunakan kotak penelusuran untuk menemukannya.

    2. Pilih Local Services API, lalu klik Aktifkan.

  3. Pilih jenis aplikasi. Local Services API menggunakan jenis aplikasi yang sama dengan Google Ads API. Untuk mengetahui detail selengkapnya tentang jenis aplikasi yang akan digunakan, lihat Memilih jenis aplikasi.

  4. Buat client ID dan rahasia klien. Untuk Local Services API, ikuti langkah-langkah yang sama untuk membuat client ID dan secret klien seperti yang digunakan untuk Google Ads API. Langkah-langkahnya sama untuk kedua kasus penggunaan.

Menggunakan Library Klien untuk mendapatkan token OAuth 2.0

Untuk mengetahui daftar library klien yang dapat Anda gunakan untuk membuat permintaan otorisasi OAuth 2.0, lihat Library klien. Ikuti petunjuk khusus library untuk mempelajari cara menggunakan token refresh guna mendapatkan token akses baru.

Cara mendapatkan token refresh OAuth 2.0

Sebaiknya gunakan library klien dalam produksi untuk mengautentikasi pengguna. Jika Anda ingin menggunakan klien HTTP untuk tujuan pengujian, gunakan petunjuk berikut untuk mendapatkan token refresh OAuth 2.0 dan token akses. Langkah 1, 2, dan 3 adalah petunjuk penyiapan satu kali yang harus Anda lakukan secara manual, dan langkah 4 dan 5 dapat diotomatiskan setelahnya untuk dijalankan tanpa intervensi manusia, seperti cron job.

  1. Download dan instal curl, alat command line untuk membuat permintaan web HTTP.

  2. Ikuti petunjuk di halaman OAuth Playground untuk mendapatkan token refresh OAuth 2.0. Gunakan cakupan berikut untuk Local Services API:

    https://www.googleapis.com/auth/adwords

    Cakupan OAuth 2.0 ini sama dengan yang digunakan oleh Google Ads API.

    Di akhir langkah ini, Anda akan menerima dua token: token refresh dan token akses. Simpan keduanya.

  3. Jalankan perintah berikut di command prompt untuk memverifikasi bahwa langkah sebelumnya berhasil:

    curl https://oauth2.googleapis.com/tokeninfo?access_token=<INSERT_ACCESS_TOKEN>

    Jika output perintah menampilkan pesan seperti berikut, berarti perintah berhasil:

    {
  "azp": "************-********************************.apps.googleusercontent.com",
  "aud": "************-********************************.apps.googleusercontent.com",
  "scope": "https://www.googleapis.com/auth/adwords [googleapis.com]",
  "exp": "1611183382",
  "expires_in": "3482",
  "access_type": "offline"
}

    Jika terjadi error atau cakupannya tidak benar, coba buat token lagi.

  4. Buat token akses baru tanpa intervensi manual. Hal ini penting karena token akses tidak berlaku lagi setiap jam. Masa berlaku token refresh jauh lebih lama, jadi Anda sering kali perlu mencabutnya secara manual jika tidak lagi diperlukan.

    Untuk mendapatkan token akses baru, jalankan perintah berikut:

    curl --data "refresh_token=<INSERT_REFRESH_TOKEN>&client_id=<INSERT_CLIENT_ID>&client_secret=<INSERT_CLIENT_SECRET>&grant_type=refresh_token" -X POST "https://oauth2.googleapis.com/token”

  5. Jalankan panggilan API berikut:

    curl -H "Authorization: Bearer <INSERT_ACCESS_TOKEN>" https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:<INSERT_10_DIGIT_MANAGER_CUSTOMER_ID_WITHOUT_HYPHENS>

    Jika panggilan ini berhasil, penyiapan Anda selesai.