การใช้งานไลบรารีของไคลเอ็นต์ Java ขั้นพื้นฐานมีดังนี้
สร้างโปรเจ็กต์ Maven หรือ Gradle ใหม่
สร้างโปรเจ็กต์ Maven หรือ Gradle ใหม่ใน IDE ที่คุณเลือก เราเผยแพร่อาร์ติแฟกต์ไปยังที่เก็บส่วนกลางของ Maven
เราขอแนะนำให้ใช้รายการวัสดุ (BOM) ของ Google Ads API เพื่อจัดการเวอร์ชันทรัพยากร Dependency
นอกจากนี้ คุณยังสร้างจากแหล่งที่มาได้ด้วย สำหรับวัตถุประสงค์ของคำแนะนำนี้ เราจะถือว่าคุณได้ตั้งค่าโปรเจ็กต์ที่มีการอ้างอิงที่จำเป็นพร้อมใช้งานแล้ว
หากคุณสร้างจากแหล่งที่มา โปรดตรวจสอบว่าได้เปิดใช้การประมวลผลคำอธิบายประกอบใน IDE
กำหนดค่าการเข้าถึง API
หากต้องการเชื่อมต่อกับ Google Ads API คุณต้องระบุข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์และการให้สิทธิ์ ดูรายละเอียดเกี่ยวกับข้อมูลเข้าสู่ระบบที่จำเป็นและวิธี กำหนดค่าไลบรารีของไคลเอ็นต์ได้ที่คู่มือการตรวจสอบสิทธิ์และการให้สิทธิ์
โทรครั้งแรก
เมื่อกำหนดค่าข้อมูลเข้าสู่ระบบแล้ว คุณก็พร้อมที่จะทำการเรียก API ครั้งแรก
เราจะเรียกใช้ GetCampaigns example เพื่อตรวจสอบข้อมูลเข้าสู่ระบบและทำการเรียกครั้งแรก
ก่อนอื่น ให้ไปที่ไดเรกทอรี google-ads-examples
cd google-ads-examples
ตัวอย่างนี้ต้องใช้--customerIdพารามิเตอร์ที่มีค่าเป็นรหัสลูกค้าบัญชี Google Ads ของคุณโดยไม่มีขีดกลาง
วิธีเรียกใช้ด้วย Gradle
./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
ดูตัวอย่างอื่นๆ
แพ็กเกจ examples ใน google-ads-examples
มีตัวอย่างที่มีประโยชน์หลายรายการ ตัวอย่างส่วนใหญ่ต้องใช้
พารามิเตอร์ คุณจะส่งพารามิเตอร์เป็นอาร์กิวเมนต์ (แนะนํา) หรือ
แก้ไขค่า INSERT_XXXXX_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'