Python istemci kitaplığı GitHub'da barındırılır ve paket PyPI'de kullanılabilir.
Şartlar
Kitaplık için Python 3.8 veya sonraki bir sürüm gereklidir.
Ön koşullar
Kitaplığı yüklemeden önce bir geliştirici jetonuna ve müşteri kimliğine ihtiyacınız vardır. Bu sertifikaları nasıl alacağınızla ilgili talimatlar ön koşullar bölümünde açıklanmıştır. Gerekli diğer OAuth2 jetonlarını sonraki adımlarda oluşturacağınızı unutmayın.
Ç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 kullanmaya başladığımızda, yayınlandıktan sonraki çeyreğin sonuna kadar en son çalışma zamanıyla uyumlu yeni bir Python istemci kitaplığı sürümü yayınlamayı hedefleriz. Örneğin, Ekim ayında yeni bir çalışma zamanı yayınlanırsa Python istemci kitaplığının uyumlu bir sürümü, sonraki yılın Mart ayı sonuna kadar kullanıma sunulur.
Kullanım ömrü sona ermiş (EOL) Python çalışma zamanları, python.org'un Desteklenmeyen Sürümler bölümündeki kullanım ömrü sona erme tarihinden sonra desteklenmez.
Python istemci kitaplığının, desteklenmeyen Python çalışma zamanları kullanım ömrünün sonuna ulaştıktan sonraki herhangi bir zamanda bu çalışma zamanlarıyla uyumlu olmayan bir sürümünü yayınlayabiliriz.
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
Kitaplığı PyPi'den yüklemek için yükleme dokümanımızdaki talimatları uygulayın ve bu sayfaya geri dönün.
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 dokümanımızda açıklanmıştır.
Kimlik doğrulama
Bir yapılandırma türü seçtikten sonra API'ye istekte bulunmak için gereken kalan OAuth2 jetonlarını oluşturmaya devam edebilirsiniz. Aşağıdaki listede belgelenen birden fazla desteklenen OAuth2 akışı vardır. Akışlar arasındaki farklar ve uygulamanız için en uygun olanı seçme konusunda yardım almak için OAuth dokümanlarımıza bakın.
API isteğinde bulunma
OAuth2 jetonlarınızı yapılandırmanıza dahil ettikten sonra API isteği göndermeye hazırsınız. Kitaplığın API istekleri yapacak şekilde doğru yapılandırıldığını test etmenin basit 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: