Panduan ini menggunakan library klien untuk mengambil kampanye Google Ads.
Untuk mengaktifkan akses API, dapatkan kredensial OAuth2 yang diperlukan terlebih dahulu.
Kemudian, tambahkan detail akun dan otorisasi ke file konfigurasi. Setelah file konfigurasi disiapkan, Anda siap untuk memanggil API.
Parameter konfigurasi untuk library klien
Menyediakan informasi berikut di file konfigurasi library klien Anda.
- Token Developer
Token developer memungkinkan aplikasi Anda mengakses API, tetapi token tersebut tidak dibatasi hanya untuk satu akun Google Ads. Setelah token disetujui, Anda dapat menggunakan token yang sama untuk permintaan terhadap semua akun Google Ads, meskipun akun tersebut tidak ditautkan ke akun pengelola Google Ads yang terkait dengan token tersebut.
Akun yang Anda kelola diotorisasi 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 buka API Center (ALAT & SETELAN > SETUP > API Center).
- 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, ID pelanggan klien dapat dikeluarkan dari file konfigurasi dan ditetapkan secara terprogram. Setelah token developer disetujui, Anda dapat menggunakan ID pelanggan klien dari akun produksi, bukan akun pengujian.
- Client ID OAuth2 dan rahasia klien
Client ID OAuth2 dan rahasia klien memetakan aplikasi klien Anda ke project di Konsol API Google dan digunakan untuk autentikasi OAuth2, sehingga aplikasi Anda dapat beroperasi atas nama akun Anda. ID ini mengidentifikasi aplikasi Anda ke Google dan memungkinkan Anda membuat token OAuth untuk mengelola pengguna Google Ads. Lihat Membuat client ID dan rahasia klien untuk mengetahui detail selengkapnya.
- 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 untuk Anda. Jika tidak, coba dapatkan token melalui OAuth Playground.
Masa berlaku token akses OAuth2 berakhir setelah waktu yang terbatas. Oleh karena itu, library klien menggunakan token refresh OAuth2 untuk membuat kembali token akses OAuth2 secara otomatis. Akses dan token refresh memiliki petunjuk untuk membuat token refresh.