วิธีการของบริการ

การออกแบบ Google Ads API แตกต่างจากสถาปัตยกรรม REST ดั้งเดิม เนื่องจากมักจะใช้วิธีการที่กำหนดเอง เช่น search และ mutate, แทน ของเมธอด list, get, create, update และ delete แบบดั้งเดิมมากขึ้น การทำงานเหล่านี้จะแสดงใน URL ของ REST โดยใช้การแมป HTTP แบบแผนของ : เพื่อแยกกริยาที่กำหนดเองออกจากส่วนที่เหลือของ URL

ตัวอย่างเช่น การเรียก API การเปลี่ยนรูปแบบแคมเปญจะใช้ URL ต่อไปนี้

https://googleads.googleapis.com/v17/customers/1234567890/campaigns:mutate

เหตุผลหนึ่งที่ API ใช้วิธีการที่กำหนดเองคือการเปิดใช้การจัดกลุ่ม ไว้ในคำขอ API เดียว อรรถศาสตร์ REST แบบเข้มงวดจะอนุญาตเฉพาะ อัปเดตทีละแคมเปญ REST ดั้งเดิม update เป็น เช่น ต้องส่งคำขอ HTTP Patch 1 รายการต่อแคมเปญ ทรัพยากร

หากต้องการอนุญาตให้การดำเนินการหลายรายการรวมไว้ด้วยกันภายในเนื้อหาคำขอเดียว Google Ads API จะกำหนดเมธอด mutate ที่กำหนดเองสำหรับทรัพยากรส่วนใหญ่แทน ในทำนองเดียวกัน หากต้องการเปิดใช้การอ่านแบบกลุ่ม (ดึงออบเจ็กต์หลายรายการพร้อมกัน) จาก API API ใช้วิธี search ที่กำหนดเองกับคำค้นหาของ Google Ads ที่เหมือนกับ SQL ภาษา

หน้าวิธีการทั่วไปมีรายละเอียดเกี่ยวกับ เมธอดที่ใช้บ่อยที่สุดใน Google Ads API