การออกแบบของ 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