Python istemci kitaplığı GitHub'da barındırılır ve paket PyPI'de kullanılabilir.
Şartlar
Kitaplık için Python 3.9 veya sonraki bir sürüm gerekir.
Ön koşullar
Bu kılavuzla devam etmeden önce Google Ads API için bir geliştirici jetonuna ve Google Ads hesabınız için 10 haneli istemci müşteri kimliğine ihtiyacınız olacaktır.
Çalışma zamanı ve bağımlılık uyumluluğu
Python istemci kitaplığı, Python Software Foundation tarafından yayınlanan Desteklenen Sürümler bölümündeki Python çalışma zamanlarıyla uyumluluğu korur. Ancak "feature" (özellik) veya "prerelease" (yayın öncesi) durumundaki sürümler bu kapsamda değildir.
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 kullanıma sunmayı hedefliyoruz.
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, EOL çalışma zamanlarıyla uyumsuz bir sürümünü EOL tarihinden sonra herhangi bir zamanda yayınlayabileceğimiz için bu çalışma zamanlarıyla uyumluluğu garanti edemeyiz.
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 uyumluluğu koruyacağız.
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ılavuzumuzda kitaplığı yüklemenin tüm farklı yolları gösterilmektedir. Kitaplığı uygulamanıza yüklemenin en basit (ve önerilen) yolu pip ile olur:
$ python -m pip install google-ads
Yapılandırma
Kitaplığı yükledikten sonra kitaplık için bir yapılandırma ayarlamanız gerekir. Kitaplığı yapılandırmanın birden fazla yolu vardır. Bu yollar yapılandırma kılavuzumuzda açıklanmaktadır.
Kimlik doğrulama
Bir yapılandırma yaklaşımı seçtikten sonra kimlik doğrulama yapılandırmanızı ayarlayabilirsiniz. Adım adım talimatlar için Python istemci kitaplığı kimlik doğrulama kılavuzumuza, daha genel bilgiler için ise OAuth'a genel bakış başlıklı makalemize bakın.
API isteğinde bulunma
Kimlik doğrulama yapılandırmanızı ayarladıktan sonra API isteğinde bulunmaya hazırsınızdır. Kitaplığın API istekleri gönderecek şekilde doğru yapılandırıldığını test etmenin hızlı bir yolu için get campaigns (kampanyaları al) örneğine bakın.
get_campaigns.py örneğini çalıştırmak için yerel olarak yüklenen googleads-python istemci kitaplığınızın kök dizininde aşağıdaki komutu çalıştırın:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
Ek kaynaklar
API isteği gönderebildikten sonra istemci kitaplığının şu kullanım alanlarına geçin: