Library klien Python dihosting di GitHub, dan paketnya tersedia di PyPI.
Persyaratan
Library ini memerlukan Python 3.9 atau yang lebih baru.
Prasyarat
Sebelum melanjutkan panduan ini, Anda memerlukan token developer untuk Google Ads API, dan ID pelanggan klien 10 digit untuk 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".
Kami 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. Kami tidak dapat menjamin kompatibilitas dengan runtime EOL, karena kami dapat merilis versi library yang tidak kompatibel dengan runtime tersebut kapan saja setelah tanggal EOL-nya.
Untuk dependensi, (khususnya, paket apa pun yang dikelola Google yang tercantum sebagai wajib oleh library klien Python), kami akan mempertahankan kompatibilitas dengan paket yang dikelola Google, dan dianggap "didukung" berdasarkan Kebijakan Perubahan Tidak Kompatibel OSS Google.
Untuk mengetahui daftar lengkap runtime dan dependensi Python yang didukung, lihat halaman Dependensi.
Penginstalan
Panduan penginstalan kami menunjukkan semua
cara berbeda untuk menginstal library. Cara paling sederhana (dan direkomendasikan) untuk menginstal library ke 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 kami.
Autentikasi
Setelah memilih pendekatan konfigurasi, Anda dapat menyiapkan konfigurasi autentikasi. Untuk petunjuk langkah demi langkah, lihat panduan autentikasi library klien Python kami, dan untuk latar belakang yang lebih umum, lihat ringkasan OAuth kami.
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, di direktori root library klien googleads-python yang diinstal secara lokal, jalankan perintah berikut:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
Referensi lainnya
Setelah Anda dapat membuat permintaan API, lanjutkan ke penggunaan library klien berikut: