Temel kullanım

Java istemci kitaplığının temel kullanımı aşağıdaki gibidir:

Yeni bir Maven veya Gradle projesi oluşturma

Seçtiğiniz IDE'de yeni bir Maven veya Gradle projesi oluşturun. Yapılar Maven Merkezi Veri Havuzu'nda yayınlanır.

Bağımlılık sürümlerini yönetmek için Google Ads API Malzeme Listesi'ni (BOM) kullanın.

google-ads-examples modülünde yer alan önceden paketlenmiş kod örneklerini çalıştırmak istiyorsanız GitHub'dan google-ads-java deposunu klonlayın veya kaynaktan derleyin. Kaynaktan derleme yapıyorsanız IDE'nizde ek açıklama işlemeyi etkinleştirdiğinizden emin olun.

API erişimini yapılandırma

Google Ads API'ye bağlanmak için kimlik doğrulama ve yetkilendirme kimlik bilgileri sağlamanız gerekir. Gerekli kimlik bilgileri ve istemci kitaplığının nasıl yapılandırılacağı hakkında ayrıntılı bilgi için Kimlik doğrulama ve yetkilendirme kılavuzu'na bakın.

İlk görüşmenizi yapın

Kimlik bilgilerinizi yapılandırdıktan sonra ilk API çağrınızı yapmaya hazırsınız.

Kimlik bilgilerinizi doğrulamak ve klonlanmış google-ads-java deposunu kullanarak ilk görüşmenizi yapmak için GetCampaigns örneğini çalıştırın.

Öncelikle google-ads-examples dizinine gidin:

cd google-ads-examples

Bu örnekte, değerin tire içermeyen 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"

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

mvn exec:java \
  -Dexec.mainClass="com.google.ads.googleads.examples.basicoperations.GetCampaigns" \
  -Dexec.args="--customerId INSERT_CUSTOMER_ID_HERE"

Diğer örnekleri inceleyin

google-ads-examples içindeki examples paketi, birkaç faydalı örnek içerir. Örneklerin çoğunda parametreler gereklidir. Parametreleri bağımsız değişken olarak iletebilir (önerilir) veya kaynak kodundaki INSERT_..._HERE yer tutucu değerlerini düzenleyebilirsiniz. Bir örnek için kullanım ifadesini görmek istiyorsanız tek bağımsız değişken olarak --help değerini iletin.

Gradle ile:

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

Ayrıca, tüm örnekleri, bir alt dizindeki örnekleri veya açıklamasında bir arama terimi bulunan ö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'