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

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

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

สร้างโปรเจ็กต์ Maven หรือ Gradle ใหม่ใน IDE ที่คุณเลือก ระบบจะเผยแพร่ Artifact ไปยังที่เก็บส่วนกลางของ 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"

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

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

หากใช้ Gradle ให้ทำดังนี้

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

นอกจากนี้ คุณยังใช้listExamplesใน 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'