Python istemci kitaplığı GitHub'da barındırılır ve paket PyPI'de bulunur.
Şartlar
Kitaplık için Python 3.8 veya daha yeni bir sürüm gerekir.
Ön koşullar
Kitaplığı yüklemeden önce geliştirici jetonuna ve istemci müşteri kimliğine ihtiyacınız vardır. Bu izinleri 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ığı, "özellik" veya "yayından önce" durumundaki 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 uyumludur.
Python çalışma ortamının yeni sürümlerini kullanıma sunarken, çalışma ortamının yayınlanmasını takip eden çeyreğin sonuna kadar Python istemci kitaplığının en son çalışma ortamıyla uyumlu yeni bir sürümünü yayınlamayı hedefliyoruz. Ö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ü Sonu (EOL) olan Python çalışma zamanları, python.org'un Desteklenmeyen Sürümler bölümündeki Kullanım Ömrü Sonu tarihinden sonra desteklenmez.
Python istemci kitaplığının, desteği sonlandırılan Python çalışma zamanlarıyla uyumlu olmayan bir sürümünü, desteği sonlandırıldıktan sonra dilediğimiz zaman yayınlayabiliriz.
Bağımlılıklar (özellikle, Python istemci kitaplığı tarafından "gerekli" olarak listelenen Google tarafından yönetilen tüm paketler) için Google tarafından yönetilen ve Google'ın OSS'de önemli değişiklik politikasına göre "desteklenen" olarak kabul edilen paketlerle uyumluluğu sürdürürüz.
Desteklenen Python çalışma zamanlarının ve bağımlılıklarının tam listesi için Bağımlılıklar sayfasına bakın.
Kurulum
Kitaplığı PyPi'den yüklemek için yükleme dokümanlarımızdaki talimatları uygulayın ve bu sayfaya 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 yöntemler yapılandırma dokümanlarımızda açıklanmıştır.
Kimlik doğrulama
Bir yapılandırma türü seçtikten sonra, API'ye istek göndermek için gereken diğer OAuth2 jetonlarını oluşturmaya devam edebilirsiniz. Desteklenen birden fazla OAuth2 akışı vardır. Bunlar aşağıdaki listede açıklanmıştır. Akışlar arasındaki farklar ve uygulamanız için en uygun akışa karar verme konusunda yardım için OAuth dokümanlarımıza bakın.
API isteği gönderme
OAuth2 jetonlarınızı yapılandırmanıza dahil ettikten sonra API isteği göndermeye hazırsınız demektir. Kitaplığın API istekleri gönderecek şekilde doğru yapılandırıldığını test etmenin basit bir yolu için get campaigns ö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: