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

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

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

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

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

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

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