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

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

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

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

ใช้ Bill of Materials (BOM) ของ Google Ads API เพื่อจัดการ เวอร์ชันการขึ้นต่อกัน

หากต้องการเรียกใช้ตัวอย่างโค้ดที่แพ็กไว้ล่วงหน้าที่รวมอยู่ใน 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"

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