Başlayın

İ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 merkez deposunda yayınlanır.

Maven bağımlılığı:

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

Gradle bağımlılığı:

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

Kaynaktan da oluşturabilirsiniz. Bu kılavuzun amacı doğrultusunda, gerekli bağımlılıkları içeren bir proje kurulumunuz olduğu varsayılmıştır.

API ile kimlik doğrulamak için kimlik bilgileri 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 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 dizi OAuth kimlik bilgisi sağlamanız gerekir.

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

Kendi kimlik bilgilerinizi kullanarak yetkilendirirseniz (masaüstü uygulama akışı)
OAuth masaüstü uygulaması akışını inceleyin. Kendi kimlik bilgilerinizle yetkilendirmek 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. Bu görselde, rastgele üçüncü taraf kullanıcılar için OAuth yetkilendirmesinin nasıl ayarlanacağına dair bir örnek gösterilmektedir.
Google Apps Alanı kullanıcısı olarak yetkilendirirseniz (hizmet hesabı akışı)
OAuth hizmet hesabı akışına bakın. Bu görselde, 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 erişiminiz bir Google Ads yönetici hesabı üzerinden sağlanıyorsa 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ı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 değer belirtilmelidir. Müşteri kimliğine giden yolda tüm yönetici hesaplarını belirtmenize gerek yoktur. Yalnızca erişim izinleri için kullandığınız en üstteki yönetici kimliğini belirtmeniz yeterlidir. Daha fazla ayrıntı için ilgili belgelere bakın.

Kimlik bilgilerinizle istemci kitaplığını 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ı kullanarak masaüstü ve web akışlarına odaklanacağız. Yalnızca bir kimlik bilgileri grubunuz varsa (örneğin, hesapları tek bir yöneticinin altında 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ğrulayın

Her şeyin doğru şekilde kurulduğundan emin olmak için GetKampanyalar örneğini çalıştırırı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 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 ürünündeki examples paketi birçok yararlı örnek içerir. Örneklerin çoğunda parametreler gerekir. Parametreleri bağımsız değişken olarak iletebilir (önerilir) veya kaynak koddaki INSERT_XXXXX_HERE değerlerini düzenleyebilirsiniz. Bir kullanım ifadesini örnek olarak 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çıklamanın bir arama terimi içerdiği örnekleri listelemek için Gradle'da 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'