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 kurulumunun yapıldığı 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'sine 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ğı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 görüşmenizi yapmak için GetCampaigns example'ı ç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 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"
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'