Java istemci kitaplığının temel kullanımı aşağıdaki gibidir:
Yeni bir Maven veya Gradle projesi oluşturma
Tercih ettiğiniz IDE'de yeni bir Maven veya Gradle projesi oluşturun. Yapılar, Maven Central deposunda 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şleyicisini 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 bilgilerini 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ılavuzunu inceleyin.
İlk aramanızı yapma
Kimlik bilgilerinizi yapılandırdıktan sonra ilk API çağrınızı yapmaya hazırsınız demektir.
Kimlik bilgilerinizi doğrulamak ve klonlanan google-ads-java deposunu kullanarak ilk çağrınızı yapmak için GetCampaigns örneğini çalıştırın.
Öncelikle google-ads-examples dizinine gidin:
cd google-ads-examples
Bu örnekte, değerin kısa çizgi 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ğu parametre gerektirir. Parametreleri bağımsız değişken olarak iletebilir (önerilir) veya kaynak kodundaki INSERT_..._HERE yer tutucu değerlerini düzenleyebilirsiniz. Bir örneğin kullanım ifadesini 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"
Gradle'da listExamples görevini kullanarak tüm örnekleri, bir alt dizindeki örnekleri veya açıklamasında bir arama terimi bulunan örnekleri de listeleyebilirsiniz:
# 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'