หน้านี้ถือว่าคุณคุ้นเคยกับการออกแบบที่เน้นทรัพยากรและคู่มือนักพัฒนาซอฟต์แวร์ชื่อทรัพยากร รวมถึงเสริมด้วยรายละเอียดการใช้งานที่เฉพาะเจาะจงของ Google Ads API
การออกแบบที่เน้นทรัพยากร
โดยทั่วไป Google Ads API เป็นไปตามการออกแบบที่เน้นทรัพยากร โดยมีลักษณะเป็นคอลเล็กชันทรัพยากรที่ระบุทีละรายการได้ (คำนามของ API) ระบบจะอ้างอิงทรัพยากรด้วยชื่อทรัพยากรและดําเนินการโดยใช้เมธอดชุดเล็ก (หรือที่เรียกว่าคํากริยาหรือการดำเนินการ)
ชื่อทรัพยากรและเมธอดเหล่านี้รวมกับคำนำหน้าเวอร์ชัน API ที่เฉพาะเจาะจงจะประกอบกันเป็น URL ของอินเทอร์เฟซ REST ตัวอย่างเช่น URL ด้านล่างนี้สามารถแยกออกเป็นคอมโพเนนต์แต่ละรายการเหล่านี้ได้ ดังที่แสดงในตารางต่อไปนี้
https://googleads.googleapis.com/v18/customers/1234567890:mutate
| คำนำหน้าเวอร์ชัน API | ชื่อทรัพยากร (แบบสัมพัทธ์) | วิธีการ |
|---|---|---|
https://googleads.googleapis.com/v18
|
customers/1234567890
|
mutate
|
URL REST ทั้งหมดสําหรับ API เวอร์ชันหนึ่งๆ (เช่น v18) ใช้คำนำหน้าเวอร์ชัน API เดียวกัน ชื่อและเมธอดของทรัพยากรจะระบุบริการ API ที่กำลังเรียกใช้
Google Ads API ใช้เมธอดที่กําหนดเองอย่างแพร่หลาย ซึ่งต่างจาก REST API แบบดั้งเดิมส่วนใหญ่ที่ใช้เมธอด REST มาตรฐาน เช่น list, get, create, update และ delete ตัวอย่างเมธอดที่กําหนดเองใน Google Ads API ได้แก่ search, searchStream และ mutate
หน้าต่อไปนี้จะอธิบายรายละเอียดเพิ่มเติมเกี่ยวกับชื่อทรัพยากร เมธอดบริการ และแบบแผนการตั้งชื่อ JSON ของ Google Ads API เพื่อแสดงให้เห็นวิธีใช้ร่วมกันเพื่อกําหนดปลายทางอินเทอร์เฟซ REST