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

การออกแบบ 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 เดียว Semantics ของ REST ที่เข้มงวดจะอนุญาตให้อัปเดตแคมเปญได้ครั้งละ 1 แคมเปญเท่านั้น ตัวอย่างเช่น REST แบบดั้งเดิม update ไปยังแคมเปญจะต้องส่งคําขอ HTTP PATCH 1 รายการต่อแหล่งข้อมูลแคมเปญ

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

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