İstemci Kitaplıkları

İstemci kitaplıklarımız, Google Ads API işlevselliğinin üst düzey görünümlerini ve temel yapı taşlarını sağlayarak uygulamaların hızlı bir şekilde geliştirilmesini sağlar. API'yi kullanmaya yeni başladıysanız işleme özellikle başlamanızı öneririz.

İstemci kitaplığı Kaynak Dağıtım Kod örnekleri
Java google-ads-java Maven, tar.gz GitHub'da göster
.NET google-ads-dotnet tar.gz, zip GitHub'da göster
PHP google-ads-php tar.gz GitHub'da göster
Python google-ads-python tar.gz, zip GitHub'da göster
Ruby google-ads-kurulu gem, tar.gz, zip GitHub'da göster
Perl google-ads-perl tar.gz, zip GitHub'da göster

Desteklenen API sürümleri

Aşağıdaki tabloda, kullanılabilir her bir API sürümünü destekleyen belirli kitaplık sürümleri listelenmektedir.

API sürümü Python kitaplığı sürümü Ruby kitaplığı sürümü PHP kitaplık sürümü Java kitaplığı sürümü .NET kitaplığı sürümü Perl kitaplığı sürümü
sürüm 11 >= 17,0,0 >= 18,0,0 >=15,1,0 >= 19,0,0 >= 12.1.0 >= 12,0,0
sürüm 10 >= 15,0,0 >= 16,0,0 >= 14.0,0 >= 17,0,0 >= 11,0,0 >= 10,0,0
v9 >= 14.1,0 >= 15,0,0 >= 12.1.0 >= 16,0,0 >= 10,2,0 >= 9,2,0

Yapılandırma

Her Ads API İstemci kitaplığı, davranışını özelleştirmek için kullanabileceğiniz farklı yapılandırma ayarları ve yükleme yöntemleri sunar.

Tüm istemci kitaplıklarında ortak olan ve yapılandırma ayarlarını yapmak için yüklenebilecek ortam değişkenlerini aşağıda bulabilirsiniz:

  • İstemci kitaplığı
    • GOOGLE_ADS_CONFIGURATION_FILE_PATH: Yapılandırma dosyasının yolu.
  • OAuth2
    • Uygulama Modu
      • GOOGLE_ADS_CLIENT_ID : Bu değeri OAuth2 istemci kimliğinize ayarlayın.
      • GOOGLE_ADS_CLIENT_SECRET : Bu değeri OAuth2 istemci gizli anahtarınız olarak ayarlayın.
      • GOOGLE_ADS_REFRESH_TOKEN : OAuth2 jetonlarını yeniden kullanmak istiyorsanız bu değeri önceden oluşturulmuş bir OAuth2 yenileme jetonu olarak ayarlayın. Bu ayar isteğe bağlıdır.
    • Hizmet Hesabı Modu
      • GOOGLE_ADS_JSON_KEY_FILE_PATH: Bu değeri OAuth2 JSON yapılandırma dosyası yoluyla ayarlayın.
      • GOOGLE_ADS_IMPERSONATED_EMAIL : Bu değeri, kimliğine büründüğünüz hesabın e-posta adresi olarak ayarlayın.
  • Google Ads API
    • GOOGLE_ADS_DEVELOPER_TOKEN : Bunu geliştirici jetonunuza ayarlayın.
    • GOOGLE_ADS_LOGIN_CUSTOMER_ID: İstekte kullanılacak yetkili müşterinin, kısa çizgi (-) olmadan kullanabileceği müşteri kimliğidir.
    • GOOGLE_ADS_LINKED_CUSTOMER_ID : Bu başlık yalnızca Google Ads kullanıcı arayüzündeki Bağlı Hesaplar aracılığıyla izin verildiğinde bir varlığın kaynaklarını güncelleyen yöntemler için gereklidir (Google Ads API'de AccountLink kaynağı). Bu değeri, belirtilen müşteri kimliğinin kaynaklarını güncelleyen veri sağlayıcısının müşteri kimliğine ayarlayın. Kısa çizgi (-) olmadan ayarlanmalıdır. Bağlı Hesaplar hakkında daha fazla bilgi edinmek için Yardım Merkezi'ni ziyaret edin.