Başlarken

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

Yeni bir Maven/Gradle projesi oluşturma

Tercih ettiğiniz IDE'de yeni bir Maven/Gradle projesi oluşturun. Yapılarımız Maven merkezi veri havuzunda yayınlanır.

Maven bağımlılığı:

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

Gradle bağımlılığı:

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

Ayrıca kaynaktan derleme de yapabilirsiniz. Bu kılavuzda, gerekli bağımlılıkların bulunduğu bir projeniz olduğu varsayılmaktadır.

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

Google Ads API'ye erişim için OAuth kimlik bilgileri ve Google Ads API geliştirici jetonu gerekir. Bu bölümde, bu özelliklerin ne olduğu, nasıl kullanıldığı ve nasıl elde edildiği açıklanmaktadır.

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

Geliştirici jetonu, bir yönetici hesabına bağlıdır ve Google Ads web arayüzünde bulunabilir.

Geliştirici jetonu bir yönetici hesabına bağlı olsa da bu hesaba erişim sağlamaz. Bunun yerine geliştirici jetonu genel olarak API'ye erişim izni verir ve 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 OAuth kimlik bilgisi grubu sağlamanız gerekir.

Genellikle kullanılan iki OAuth akışı vardır: masaüstü (yüklü) uygulama veya web uygulaması. İkisi arasındaki temel fark, masaüstü uygulamalarının Google'ın yetkilendirme sunucusundan gelen yanıtları işlemek için sistem tarayıcısını açması ve yerel bir yönlendirme URI'si sağlaması, web uygulamalarının ise yetkilendirmeyi tamamlamak ve kimlik bilgilerini sunucunuza geri göndermek için herhangi bir üçüncü taraf tarayıcıyı yönlendirebilmesidir. Kitaplık, daha az kullanılan hizmet hesabı akışını da destekler.

Kendi kimlik bilgilerinizi kullanarak yetki veriyorsanız (masaüstü uygulaması akışı)
OAuth masaüstü uygulaması akışına bakın. Bu, kendi kimlik bilgilerinizle yetkilendirme için ihtiyaç duyduğunuz tüm ayrıntıları içerir.
Üçüncü taraf Google kullanıcısı olarak yetkilendiriyorsanız (web akışı)
OAuth web uygulaması akışına bakın. Bu örnekte, rastgele üçüncü taraf kullanıcıları için OAuth yetkilendirmesinin nasıl ayarlanacağı gösterilmektedir.
Google Apps alanı kullanıcısı olarak yetkilendirirseniz (hizmet hesabı akışı)
OAuth hizmet hesabı akışına bakın. Bu örnekte, Google Apps alanı kullanıcıları için OAuth yetkilendirmesinin nasıl ayarlanacağı gösterilmektedir.

Google Ads müşteri hesabına erişiminiz bir Google Ads yönetici hesabı üzerindense aşağıda açıklandığı şekilde bir giriş müşteri kimliği de belirtmeniz gerekir.

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

İsteğe bağlı olarak, reklam sunma hesabına erişim sağlayan bir yönetici hesabının müşteri kimliğini belirtin. Müşteri hesabına erişiminiz bir yönetici hesabı üzerinden ise bu belirtilmelidir. Müşteri kimliğinin yolundaki tüm yönetici hesaplarını belirtmeniz gerekmez. Yalnızca erişim izinleri için kullandığınız en üst düzey yönetici kimliğini belirtmeniz yeterlidir. Daha fazla bilgi için ilgili belgelere bakın.

İstemci kitaplığını kimlik bilgilerinizle yapılandırma

İstemci kitaplığını bir yapılandırma dosyasıyla, ortam değişkenleriyle veya programatik olarak yapılandırabilirsiniz. Bu kılavuzda yapılandırma dosyası yaklaşımını kullanacak ve masaüstü ve web akışlarına odaklanacağız. Yalnızca bir kimlik bilgisi grubunuz varsa (örneğin, tek bir yöneticinin altındaki hesapları yönetiyorsanız) yapılandırma dosyası kullanmak genellikle iyi bir yaklaşımdır.

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 giriş yapan müşteri olarak bu hesabın müşteri kimliğini belirtmeniz gerekir:

api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

Kimlik bilgilerini doğrulama

Her şeyin doğru ayarlandığından emin olmak için GetCampaigns örneğini çalıştıracağız.

Öncelikle google-ads-examples dizinine gidin.

$ cd google-ads-examples

Bu örnekte, değerin tire işareti olmadan Google Ads hesabınızın müşteri kimliği olduğu bir --customerId parametresi gerekir.

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 içindeki examples paketinde birkaç yararlı örnek bulunur. Örneklerin çoğunda parametre gerekir. Parametreleri bağımsız değişken olarak iletebilir (önerilir) veya kaynak koddaki INSERT_XXXXX_HERE değerlerini düzenleyebilirsiniz. Bir örnek kullanım beyanı görmek için tek bağımsız değişken olarak --help değerini iletin.

Gradle ile:

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

Tüm örnekleri, bir alt dizindeki örnekleri veya açıklamasında arama terimi bulunan örnekleri listelemek için Gradle'deki listExamples görevini de kullanabilirsiniz.

# 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'