Başlayın

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

Yeni bir Maven/Gradle projesi oluşturun

İstediğiniz IDE'de yeni bir Maven/Gradle projesi oluşturun. Yapılarımız Maven merkezi deposunda yayınlanmaktadır.

Maven bağımlılığı:

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

Gradle bağımlılığı:

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

Kaynaktan da oluşturabilirsiniz. Bu kılavuzda, gerekli bağımlılıkların mevcut olduğu bir proje kurulumunuz olduğu varsayılır.

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

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

Geliştirici simgesi (API'ya 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 dizi OAuth kimlik bilgisi sağlamanız gerekir.

Genellikle iki OAuth akışı kullanılı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çıp yerel bir yönlendirme URI'si sağlamasıdır. Öte yandan, web uygulamaları, yetkilendirmeyi tamamlamak ve kimlik bilgilerini tekrar sunucunuza göndermek için rastgele bir üçüncü taraf tarayıcıyı yönlendirebilir. Kitaplık, daha az kullanılan hizmet hesabı akışını da destekler.

Kendi kimlik bilgilerinizi kullanarak yetkilendiriyorsanız (masaüstü uygulaması akışı)
OAuth masaüstü uygulaması akışını inceleyin. Kendi kimlik bilgilerinizle yetkilendirme için ihtiyacınız olan tüm ayrıntılar buna dahildir.
Üçüncü taraf Google kullanıcısı olarak yetkilendirirseniz (web akışı)
OAuth web uygulaması akışını inceleyin. Burada, rastgele üçüncü taraf kullanıcılar için OAuth yetkilendirmesinin nasıl ayarlanacağına dair bir örnek verilmiştir.
Google Apps Alanı kullanıcısı olarak yetkilendirirseniz (hizmet hesabı akışı)
OAuth hizmet hesabı akışını inceleyin. Burada, Google Apps Alanı kullanıcıları için OAuth yetkilendirmesinin nasıl ayarlanacağına dair bir örnek verilmiştir.

Google Ads müşteri hesabına bir Google Ads yönetici hesabı ü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ş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. Bu, müşteri hesabına erişiminiz bir yönetici hesabı üzerinden gerçekleşiyorsa belirtilmelidir. Müşteri kimliğine giden yolda tüm yönetici hesaplarını belirtmeniz gerekmez. Yalnızca erişim izinleri için kullandığınız en üstteki yönetici kimliğini belirtmeniz gerekir. Daha ayrıntılı bilgi için ilgili belgelere bakın.

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

İstemci kitaplığını bir yapılandırma dosyası, ortam değişkenleri veya programatik olarak yapılandırabilirsiniz. Bu kılavuzda, yapılandırma dosyası yaklaşımını kullanarak masaüstü ve web akışlarına odaklanacağız. Yapılandırma dosyası kullanmak, yalnızca tek bir kimlik bilginiz varsa (örneğin, hesapları tek bir yönetici altında yönetiyorsanız) 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 bu hesabın müşteri kimliğini giriş müşterisi olarak belirtmeniz gerekir:

api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

Kimlik bilgilerini doğrulayın

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

İlk olarak google-ads-examples dizinine gidin.

$ cd google-ads-examples

Bu örnekte, değerin kısa çizgi olmadan Google Ads hesabı müşteri kimliğiniz olduğu bir --customerId parametresi gereklidir.

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ç faydalı örnek bulunmaktadır. Örneklerin çoğu parametre gerektirir. Parametreleri bağımsız değişken olarak iletebilir (önerilir) veya kaynak kodundaki INSERT_XXXXX_HERE değerlerini düzenleyebilirsiniz. Örnek bir kullanım ifadesini görmek için --help öğesini tek bağımsız değişken olarak iletin.

Gradle ile:

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

Tüm örnekleri, bir alt dizindeki örnekleri veya açıklamanın bir arama terimi içerdiği örnekleri listelemek için Gradle'daki 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'