Penggunaan dasar library klien Java adalah sebagai berikut:
Membuat project Maven atau Gradle baru
Buat project Maven atau Gradle baru di IDE pilihan Anda. Artefak kami dipublikasikan ke repositori pusat Maven.
Sebaiknya gunakan Bill of Materials (BOM) Google Ads API untuk mengelola versi dependensi.
Anda juga dapat membangun dari sumber. Untuk tujuan panduan ini, diasumsikan bahwa Anda telah menyiapkan project dengan dependensi yang diperlukan.
Jika Anda membangun dari sumber, pastikan Anda mengaktifkan pemrosesan anotasi di IDE Anda.
Mengonfigurasi akses API
Untuk terhubung ke Google Ads API, Anda harus memberikan kredensial autentikasi dan otorisasi. Lihat panduan Autentikasi dan Otorisasi untuk mengetahui detail tentang kredensial yang diperlukan dan cara mengonfigurasi library klien.
Melakukan panggilan pertama Anda
Setelah mengonfigurasi kredensial, Anda siap melakukan panggilan API pertama.
Untuk memvalidasi kredensial Anda dan melakukan panggilan pertama, kita akan menjalankan contoh GetCampaigns.
Pertama, buka direktori google-ads-examples.
cd google-ads-examples
Contoh ini memerlukan parameter --customerId dengan nilai ID pelanggan akun Google Ads Anda tanpa tanda hubung.
Untuk menjalankan dengan Gradle:
./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
Jelajahi contoh lainnya
Paket examples di google-ads-examples
berisi beberapa contoh yang berguna. Sebagian besar contoh memerlukan
parameter. Anda dapat meneruskan parameter sebagai argumen (direkomendasikan) atau
mengedit nilai INSERT_XXXXX_HERE dalam kode sumber. Untuk melihat pernyataan penggunaan
untuk contoh, teruskan --help sebagai satu-satunya argumen.
Dengan Gradle:
./gradlew -q runExample --example="basicoperations.GetCampaigns --help"
Anda juga dapat menggunakan tugas listExamples di Gradle untuk mencantumkan semua contoh, contoh di subdirektori, atau contoh yang deskripsinya menyertakan istilah penelusuran.
# 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'