Java istemci kitaplığının temel kullanımı şu şekildedir:
Yeni bir Maven veya Gradle projesi oluşturma
Seçtiğiniz IDE'de yeni bir Maven veya Gradle projesi oluşturun. Yapılarımız Maven merkezi veri havuzunda yayınlanır.
Bağımlılık sürümlerini yönetmek için Google Ads API'nin Malzeme Listesi'ni (BOM) kullanmanızı öneririz.
Kaynaktan da derleyebilirsiniz. Bu kılavuzda, gerekli bağımlılıkların bulunduğu bir projenin kurulu olduğu varsayılmaktadır.
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 bilgilerini sağlamanız gerekir. Gerekli kimlik bilgileri ve istemci kitaplığının nasıl yapılandırılacağıyla ilgili ayrıntılar 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 ilk çağrınızı yapmak 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 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"
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_XXXXX_HERE değerlerini düzenleyebilirsiniz. Örnek bir 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"
Tüm örnekleri, bir alt dizindeki örnekleri veya açıklamasında 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'