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 gereklidir.
Ön koşullar
Bu kılavuzla devam etmeden önce Google Ads API için bir geliştirici jetonuna ve Google Ads hesabınızın 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ığı, "özellik" veya "yayın öncesi" durumuna sahip sürümler hariç olmak üzere, Python Software Foundation tarafından yayınlanan Desteklenen Sürümler bölümündeki Python çalışma zamanlarıyla uyumluluğu korur.
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, kullanım ömrü sonu tarihinden sonraki herhangi bir zamanda bu çalışma zamanlarıyla uyumsuz bir sürümünü yayınlayabileceğimiz için kullanım ömrü sonu ç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
Yapılandırma yaklaşımını 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 yapacak ş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ımlarına geçin: