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