Python istemci kitaplığı GitHub'da barındırılır ve paket PyPI'de kullanılabilir.
Ş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ılavuzla devam etmeden önce Google Ads hesabınızın 10 haneli müşteri kimliğine ihtiyacınız vardır.
Ç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 bakımı yapılan tüm paketler) için Google tarafından bakımı yapılan ve Google'ın OSS Breaking Change Policy'sine göre "desteklenen" olarak kabul edilen paketlerle uyumluluk korunur.
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
Bir yapılandırma yaklaşımı 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 bilgisi 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 gönderecek şekilde doğru yapılandırıldığını hızlı bir şekilde test etmek için get campaigns (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, klonlanmış 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: