Başlarken

İstemci kitaplığını Apache Maven (veya Gradle) ile kullanmanızı öneririz.

Yeni bir Maven/Gradle projesi oluşturun

Tercih ettiğiniz IDE'de yeni bir Maven/Gradle projesi oluşturun. Eserlerimiz Maven Central'da yayınlandı depo.

Maven bağımlılığı:

<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
  <version>33.0.0</version>
</dependency>

Gradle bağımlılığı:

implementation 'com.google.api-ads:google-ads:33.0.0'

Kaynaktan da oluşturabilirsiniz. Bu amaca yönelik olarak, gerekli bağımlılıklara sahip bir proje kurulumunuz olduğu varsayılır. kullanılabilir.

API ile kimlik doğrulamak için kimlik bilgileri alma

Google Ads API'ye erişim için OAuth kimlik bilgileri ve Google Ads API geliştiricisi gereklidir jeton. Bu bölümde bunların ne olduğu, nasıl kullanıldığı ve nasıl yardımcı olur.

Geliştirici jetonu (API'ye erişim için)

Geliştirici jetonu bir yöneticiye bağlı hesabınıza giriş yapar ve Google Ads web arayüzünde bulunabilir.

Geliştirici jetonu bir yönetici hesabına bağlı olsa da o hesaba erişebilir. Bunun yerine, geliştirici jetonu hesap düzeyinde erişim OAuth aracılığıyla yapılandırılır.

OAuth kimlik bilgileri (Google Ads hesaplarına erişim için)

Google Ads hesaplarına erişimi olan Google Hesabı kullanıcıları olarak yetkilendirmek için bir dizi OAuth kimlik bilgisi sağlamalıdır.

Genellikle kullanılan iki OAuth akışı vardır: masaüstü (yüklü) uygulama veya web uygulaması. İkisi arasındaki en önemli fark, masaüstü uygulamalarının sistem tarayıcısını açın ve şuradan gelen yanıtları işlemek için bir yerel yönlendirme URI'si sağlayın: Google'ın yetkilendirme sunucusu, web uygulamaları ise rastgele üçüncü taraf tarayıcıyı kullanarak yetkilendirmeyi tamamlama ve kimlik bilgilerini tekrar . Kitaplık, daha seyrek kullanılan hizmet hesabını da destekler akışı sağlar.

Kendi kimlik bilgilerinizi kullanarak yetkilendirirseniz (masaüstü uygulama akışı)
bkz. OAuth masaüstü uygulaması uygulayın. Bu, sahip olduğunuz tüm bilgileri kimlik bilgileriniz ile yetki vermeniz gerekir.
Üçüncü taraf Google kullanıcısı olarak yetkilendirirseniz (web akışı)
OAuth web uygulaması akışını inceleyin. Bu rastgele üçüncü taraf için OAuth yetkilendirmesinin nasıl ayarlanacağına dair bir örnek sunar daha fazla kullanıcıya ulaşabiliyoruz.
Google Apps Alanı kullanıcısı olarak yetkilendirirseniz (hizmet hesabı akışı)
OAuth hizmet hesabına bakın uygulayın. Bu, Arkadaş Bitkiler projesinin Google Apps Alanı kullanıcıları için OAuth yetkilendirmesini ayarlayın.

Google Ads müşteri hesabına bir Google Ads yöneticisi üzerinden erişiyorsanız aşağıda açıklandığı gibi bir giriş müşteri kimliği de belirtmeniz gerekir.

Giriş müşteri kimliği (yönetici hesabı üzerinden Google Ads hesaplarına erişmek için)

İsteğe bağlı olarak, reklam sunma hesabında. Müşteriye erişiminizse bu alan belirtilmelidir bir yönetici hesabı üzerinden alınıyor. Tüm yöneticileri belirtmenize gerek yoktur müşteri kimliğine giden yolda hesaplar, yalnızca sizin oluşturduğunuz en üst yönetici kimliği kullanıyor. Daha fazla bilgi için ilgili dokümanlarına göz atın.

Kimlik bilgilerinizle istemci kitaplığını yapılandırma

İstemci kitaplığını bir yapılandırma dosyasıyla yapılandırabilirsiniz. ortam değişkenlerini kullanarak ya da programatik olarak. Bu kılavuzda, yapılandırma dosyası yaklaşımına ve masaüstü ile web akışlarına odaklanma. Bir Yalnızca tek bir yapılandırma kümesi kullanıyorsanız Kimlik bilgileri (örneğin, hesapları tek bir yönetici altında yönetiyorsanız).

Aşağıdaki içeriğe sahip bir ~/ads.properties dosyası oluşturun:

api.googleads.clientId=INSERT_CLIENT_ID_HERE
api.googleads.clientSecret=INSERT_CLIENT_SECRET_HERE
api.googleads.refreshToken=INSERT_REFRESH_TOKEN_HERE
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE

Yer tutucuları önceki adımda aldığınız kimlik bilgilerinizle değiştirin.

Ayrıca, yenileme jetonunuz bir yönetici hesabı içinse bu hesabın müşteri kimliğini giriş yapan müşteri olarak belirt:

api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

Kimlik bilgilerini doğrulayın

Her şeyin doğru yapılandırıldığından emin olmak için Kampanyalar Alımı'nı örnek bölümüne bakın.

İlk olarak google-ads-examples dizinine gidin.

$ cd google-ads-examples

Bu örnekte, değerin size ait olduğu bir --customerId parametresi gerekiyor. Kısa çizgi içermeyen Google Ads hesabı müşteri kimliği.

Gradle ile çalıştırmak için:

$ ./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"

Diğer örnekleri keşfedin

google-ads-examples konumundaki örnekler paketi pratik örnekler içerir. Örneklerin çoğunda parametreleridir. Parametreleri bağımsız değişken olarak iletebilir (önerilir) veya kaynak koddaki INSERT_XXXXX_HERE değerlerini düzenleyin. Kullanım bildirimini görmek için Örneğin, tek bağımsız değişken olarak --help değerini geçirin.

Gradle ile:

$ ./gradlew -q runExample --example="basicoperations.GetCampaigns --help"

Tüm örnekleri listelemek için Gradle'da listExamples görevini de kullanabilirsiniz. alt dizindeki örnekler veya açıklamanın bir arama içerdiği örnekler terim.

# List all examples:
$ ./gradlew -q listExamples
# List examples in the 'basicoperations' subdirectory:
$ ./gradlew -q listExamples --subdirectory='basicoperations'
# Search for examples where the description includes 'Performance Max':
$ ./gradlew -q listExamples --searchTerm='Performance Max'