Python istemci kitaplığı GitHub'da barındırılır ve paket PyPI'da mevcuttur.
Şartlar
Kitaplık, Python 3.9'dan 3.14'e kadar olan sürümleri destekler (>=3.9, <3.15; Python 3.14 desteği v28.2.0 sürümünde eklenmiştir). Python 3.9 ve 3.10, google-ads v32.0.0 ve sonraki sürümlerde içe aktarma sırasında kullanımdan kaldırma uyarısı verdiğinden Python 3.11 veya sonraki sürümlerin kullanılması önerilir.
Ön koşullar
Bu kılavuzdaki adımları uygulamadan önce Google Ads hesabınızın 10 haneli müşteri kimliğini öğrenmeniz gerekir.
Çalışma zamanı ve bağımlılık uyumluluğu
Python istemci kitaplığı, Desteklenen Sürümler bölümünde Python Software Foundation tarafından yayınlanan Python çalışma zamanlarıyla uyumluluğu korur. Ancak "feature" (özellik) veya "prerelease" (ön sürüm) durumuna sahip sürümler bu kapsamda değildir.
Google Ads API Ekibi, Python çalışma zamanının yeni sürümlerini yayınlanır yayınlanmaz ve Python Software Foundation tarafından resmi olarak desteklenir desteklenmez kullanmayı amaçlamaktadır.
Kullanım ömrü sona ermiş (EOL) Python çalışma zamanları, python.org'un Desteklenmeyen Sürümler bölümündeki EOL tarihinden sonra desteklenmez. Kitaplığın, kullanım ömrü sonu tarihinden sonraki sürümleri uyumluluğu bozabileceğinden kullanım ömrü sonu çalışma zamanlarıyla uyumluluk garanti edilemez.
Bağımlılıklar (özellikle Python istemci kitaplığı tarafından gerekli olarak listelenen, Google tarafından yönetilen tüm paketler) için uyumluluk, Google tarafından yönetilen ve Google'ın OSS Zarar Veren Değişiklik Politikası'na göre "desteklenen" olarak kabul edilen paketlerle sağlanır.
Desteklenen Python çalışma zamanlarının ve bağımlılıkların tam listesi için Bağımlılıklar sayfasına bakın.
Kurulum
Yükleme kılavuzunda, kitaplığı yüklemenin tüm farklı yolları açıklanmaktadır. Kitaplığı uygulamanıza yüklemenin en basit (ve önerilen) yolu pip kullanmaktır:
python -m pip install google-ads
Yapılandırma
Kitaplığı yükledikten sonra yapılandırmanız gerekir. Kitaplığı yapılandırmanın birden fazla yolu vardır. Bu yollar yapılandırma kılavuzunda açıklanmıştır.
Kimlik doğrulama
Yapılandırma yaklaşımını seçtikten sonra kimlik doğrulama yapılandırmanızı ayarlayın. Adım adım talimatlar için Python istemci kitaplığı kimlik doğrulama kılavuzuna bakın. Daha genel bir arka plan için OAuth'a genel bakış başlıklı makaleyi inceleyin.
API isteğinde bulunma
Kimlik doğrulama yapılandırmanızı ayarladıktan sonra API isteğinde bulunmaya hazırsınız. Kitaplığın API istekleri yapacak şekilde doğru yapılandırıldığını test etmenin hızlı bir yolu için kampanyaları alma örneğine bakın.
get_campaigns.py örneğini çalıştırmak için önce google-ads-python deposunu klonlayın. Ardından, klonlanan deponun kök dizininden aşağıdaki komutu çalıştırın:
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
Ek kaynaklar
API isteği gönderebildikten sonra istemci kitaplığının aşağıdaki kullanımlarına geçin: