Library klien Python dihosting di GitHub, dan paketnya tersedia di PyPI.
Persyaratan
Library ini mendukung Python 3.9 hingga 3.14 (>=3.9, <3.15; dukungan Python 3.14
ditambahkan di v28.2.0). Karena Python 3.9 dan 3.10 memunculkan peringatan
penggunaan yang tidak disarankan saat mengimpor di google-ads v32.0.0 dan yang lebih baru, sebaiknya gunakan Python 3.11 atau
yang lebih baru.
Prasyarat
Sebelum melanjutkan panduan ini, Anda memerlukan ID pelanggan klien 10 digit akun Google Ads Anda.
Kompatibilitas runtime dan dependensi
Library klien Python mempertahankan kompatibilitas dengan runtime Python di bagian Versi yang Didukung yang dipublikasikan oleh Python Software Foundation, kecuali untuk versi dengan status "fitur" atau "pra-rilis".
Tim Google Ads API berupaya mengadopsi versi baru runtime Python segera setelah dirilis dan didukung secara resmi oleh Python Software Foundation.
Runtime Python yang telah mencapai akhir siklus proses (EOL) tidak didukung setelah tanggal EOL di bagian Versi yang Tidak Didukung di python.org. Kompatibilitas dengan runtime EOL tidak dapat dijamin, karena rilis library setelah tanggal EOL dapat merusak kompatibilitas.
Untuk dependensi (khususnya, paket yang dikelola Google yang tercantum sebagai wajib oleh library klien Python), kompatibilitas dipertahankan dengan paket yang dikelola Google dan dianggap "didukung" sesuai dengan Kebijakan Perubahan Tidak Kompatibel OSS Google.
Untuk mengetahui daftar lengkap dependensi dan runtime Python yang didukung, lihat halaman Dependensi.
Penginstalan
Panduan penginstalan menguraikan semua cara berbeda untuk
menginstal library. Cara paling sederhana (dan direkomendasikan) untuk menginstal library
ke dalam aplikasi Anda adalah dengan pip:
python -m pip install google-ads
Konfigurasi
Setelah menginstal library, Anda perlu menyiapkan konfigurasi untuk library tersebut. Ada beberapa cara untuk mengonfigurasi library, yang dijelaskan dalam panduan konfigurasi.
Autentikasi
Setelah memilih pendekatan konfigurasi, siapkan konfigurasi autentikasi Anda. Untuk mengetahui petunjuk langkah demi langkah, lihat panduan autentikasi library klien Python. Untuk latar belakang yang lebih umum, lihat ringkasan OAuth.
Membuat permintaan API
Setelah menyiapkan konfigurasi autentikasi, Anda siap membuat permintaan API. Lihat contoh get campaigns untuk cara cepat menguji apakah library dikonfigurasi dengan benar untuk membuat permintaan API.
Untuk menjalankan contoh get_campaigns.py, pertama-tama clone
repositori google-ads-python. Kemudian, dari direktori root repositori yang di-clone, jalankan perintah berikut:
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
Referensi lainnya
Setelah Anda dapat membuat permintaan API, lanjutkan ke penggunaan library klien berikut: