Penggunaan dasar

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 dipublikasikan ke repositori Maven Central.

Gunakan Bill of Materials (BOM) Google Ads API untuk mengelola versi dependensi.

Jika Anda ingin menjalankan contoh kode yang telah dipaketkan dan disertakan dalam modul google-ads-examples, clone repositori google-ads-java dari GitHub atau bangun dari sumber. Jika Anda mem-build dari sumber, pastikan Anda mengaktifkan pemrosesan anotasi di IDE.

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 dan melakukan panggilan pertama menggunakan repositori google-ads-java yang di-clone, jalankan contoh GetCampaigns.

Pertama, buka direktori google-ads-examples:

cd google-ads-examples

Contoh ini memerlukan parameter --customerId dengan nilai berupa ID pelanggan akun Google Ads Anda tanpa tanda hubung (-).

Untuk menjalankan dengan Gradle:

./gradlew -q runExample \
  --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"

Untuk menjalankan dengan Maven:

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

Mempelajari 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 placeholder INSERT_..._HERE dalam kode sumber. Untuk melihat pernyataan penggunaan 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'