Panduan Memulai

Panduan ini menggunakan library klien untuk mengambil kampanye Google Ads.

Untuk mengaktifkan akses API, dapatkan kredensial OAuth2 yang diperlukan terlebih dahulu. Kemudian, tambahkan detail otorisasi dan akun ke file konfigurasi. Setelah file konfigurasi disiapkan, Anda siap memanggil API.

Prasyarat

Parameter konfigurasi

Anda harus memberikan informasi berikut dalam file konfigurasi library klien.

Token Developer

Token developer memungkinkan aplikasi Anda mengakses API, tetapi token tidak dibatasi hanya untuk satu akun Google Ads. Setelah token disetujui, Anda dapat menggunakan token yang sama untuk permintaan terhadap semua akun Google Ads Anda, meskipun akun tersebut tidak ditautkan ke Akun Pengelola Google Ads yang terkait dengan token tersebut. Akun yang Anda kelola diberi otorisasi oleh kredensial OAuth dari akun pengelola. Akun pengelola hanya memerlukan satu kumpulan kredensial untuk mengelola semua sub-akunnya.

Hanya token yang disetujui yang dapat terhubung ke API untuk akun Google Ads produksi; token yang tertunda hanya dapat terhubung ke akun pengujian.

Anda dapat mengambil token developer dengan login ke akun pengelola, lalu membuka Pusat API (ALAT & SETTINGS > SETUP > API Center).

Poin Utama

  • Perusahaan sebaiknya hanya memiliki satu token developer.
  • Setelah client ID dari project Google Cloud digunakan dengan token developer, client ID terikat dengan token developer dan tidak dapat digunakan dengan token developer lain. Dengan kata lain:
    • Token developer dapat digunakan dengan beberapa client ID.
    • Namun, client ID hanya dapat digunakan dengan satu token developer.
Nomor pelanggan klien

Client ID klien adalah nomor akun dari akun klien Google Ads yang ingin Anda kelola dengan API, biasanya dalam bentuk 123-456-7890.

Secara opsional, client ID klien dapat tidak dicantumkan dalam file konfigurasi dan ditetapkan secara terprogram. Setelah token developer disetujui, Anda dapat menggunakan ID pelanggan klien dari akun produksi, bukan akun pengujian.

Rahasia klien dan client ID OAuth2

Client ID dan rahasia klien OAuth2 memetakan aplikasi klien Anda ke project di Konsol API Google dan digunakan untuk autentikasi OAuth2, sehingga aplikasi Anda dapat beroperasi atas nama akun. Metode ini mengidentifikasi aplikasi Anda ke Google dan memungkinkan Anda membuat token OAuth untuk mengelola pengguna Google Ads.

Baca Membuat client ID dan rahasia klien untuk mengetahui detail lebih lanjut.

Token akses dan refresh OAuth2

Sebelum dapat mengakses data pribadi menggunakan API, aplikasi Anda harus mendapatkan token akses OAuth2 yang memberikan akses ke API.

Jika Anda menggunakan library klien, token akses OAuth2 akan otomatis ditangani. Jika tidak, lihat contoh panggilan API di panduan OAuth2 untuk mengetahui detail tentang cara membuat token akses.

Masa berlaku token akses OAuth2 akan berakhir setelah waktu yang terbatas. Karena alasan ini, library klien menggunakan token refresh OAuth2 untuk membuat kembali token akses OAuth2 secara otomatis.

Token akses dan refresh OAuth2 memiliki petunjuk untuk membuat token refresh.

Untuk informasi selengkapnya tentang penggunaan OAuth2 dengan Google API, baca dokumentasi Autentikasi2 OAuth2 dan Platform Identitas OAuth2.