Panduan Memulai

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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.