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 memanggil API.
Parameter konfigurasi untuk library klien
Berikan informasi berikut di file konfigurasi library klien.
- 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 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 buka Pusat API (ALAT & SETELAN > PENGATURAN > API Center).
- Nomor pelanggan klien
ID pelanggan klien adalah nomor akun akun klien Google Ads yang ingin Anda kelola dengan API, biasanya dalam bentuk
123-456-7890.
Secara opsional, ID pelanggan klien dapat diabaikan dari file konfigurasi dan ditetapkan secara terprogram. Setelah token developer disetujui, Anda dapat menggunakan client ID klien dari akun produksi, bukan akun pengujian.
- Client ID dan rahasia klien 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. 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 ditangani secara otomatis untuk Anda. Jika tidak, coba dapatkan token melalui OAuth Playground.
Masa berlaku token akses OAuth2 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 memiliki petunjuk untuk membuat token refresh.