การใช้งานพื้นฐาน

การใช้งานพื้นฐานของไลบรารีของไคลเอ็นต์ Java มีดังนี้

สร้างโปรเจ็กต์ Maven หรือ Gradle ใหม่

สร้างโปรเจ็กต์ Maven หรือ Gradle ใหม่ใน IDE ที่คุณเลือก อาร์ติแฟกต์จะเผยแพร่ไปยังที่เก็บส่วนกลางของ Maven

ใช้รายการวัสดุ (BOM) ของ Google Ads API เพื่อจัดการเวอร์ชันทรัพยากร Dependency

หากต้องการเรียกใช้ตัวอย่างโค้ดที่จัดแพ็กเกจไว้ล่วงหน้าซึ่งรวมอยู่ในโมดูล google-ads-examples ให้โคลนที่เก็บ google-ads-java จาก GitHub หรือสร้างจากแหล่งที่มา หากคุณสร้างจากแหล่งที่มา ให้ตรวจสอบว่าคุณได้เปิดใช้การประมวลผลคำอธิบายประกอบใน IDE แล้ว

กำหนดค่าการเข้าถึง API

หากต้องการเชื่อมต่อกับ Google Ads API คุณต้องระบุข้อมูลเข้าสู่ระบบสำหรับการตรวจสอบสิทธิ์และการให้สิทธิ์ ดูรายละเอียดเกี่ยวกับข้อมูลเข้าสู่ระบบที่จำเป็นและวิธีกำหนดค่าไลบรารีของไคลเอ็นต์ได้ที่คู่มือการตรวจสอบสิทธิ์และการให้สิทธิ์

โทรออกครั้งแรก

เมื่อกำหนดค่าข้อมูลเข้าสู่ระบบแล้ว คุณก็พร้อมที่จะทำการเรียก API ครั้งแรก

หากต้องการตรวจสอบข้อมูลเข้าสู่ระบบและทำการเรียกครั้งแรกโดยใช้ที่เก็บ google-ads-java ที่โคลน ให้เรียกใช้ตัวอย่าง GetCampaigns

ก่อนอื่น ให้ไปที่ไดเรกทอรี google-ads-examples โดยทำดังนี้

cd google-ads-examples

ตัวอย่างนี้ต้องใช้พารามิเตอร์ --customerId โดยที่ค่าคือรหัสลูกค้าของบัญชี Google Ads ที่ไม่มีขีดกลาง (-)

วิธีเรียกใช้ด้วย Gradle

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

วิธีเรียกใช้ด้วย Maven

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

ดูตัวอย่างอื่นๆ

แพ็กเกจ examples ใน google-ads-examples มีตัวอย่างที่เป็นประโยชน์หลายรายการ ตัวอย่างส่วนใหญ่ต้องใช้พารามิเตอร์ คุณสามารถส่งพารามิเตอร์เป็นอาร์กิวเมนต์ (แนะนำ) หรือแก้ไขค่าตัวยึดตำแหน่ง INSERT_..._HERE ในซอร์สโค้ดก็ได้ หากต้องการดูคำสั่งการใช้งานสำหรับตัวอย่าง ให้ส่ง --help เป็นอาร์กิวเมนต์เดียว

เมื่อใช้ Gradle ให้ทำดังนี้

./gradlew -q runExample --example="basicoperations.GetCampaigns --help"

นอกจากนี้ คุณยังใช้ listExamples task ใน Gradle เพื่อแสดงรายการตัวอย่างทั้งหมด ตัวอย่างในไดเรกทอรีย่อย หรือตัวอย่างที่คำอธิบายมีข้อความค้นหาได้ด้วย

# 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'