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

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

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

https://googleads.googleapis.com/v16/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