หน้านี้ถือว่าคุณคุ้นเคยกับการออกแบบที่เน้นทรัพยากรและคู่มือนักพัฒนาซอฟต์แวร์ชื่อทรัพยากร รวมถึงเสริมด้วยรายละเอียดการใช้งานที่เฉพาะเจาะจงของ Google Ads API
การออกแบบที่เน้นทรัพยากร
โดยทั่วไป Google Ads API เป็นไปตามการออกแบบที่เน้นทรัพยากร โดยมีลักษณะเป็นคอลเล็กชันทรัพยากรที่ระบุทีละรายการได้ (คำนามของ API)
ระบบจะอ้างอิงทรัพยากรด้วยชื่อทรัพยากรและดําเนินการโดยใช้เมธอด (หรือที่เรียกว่าคํากริยาหรือการดำเนินการ) ชุดเล็กๆ
ชื่อทรัพยากรและเมธอดเหล่านี้รวมกับคำนำหน้าเวอร์ชัน API ที่เฉพาะเจาะจงจะประกอบกันเป็น URL ของอินเทอร์เฟซ REST
ตัวอย่างเช่น URL ด้านล่างนี้สามารถแยกออกเป็นคอมโพเนนต์แต่ละรายการเหล่านี้ได้ ดังที่แสดงในตารางต่อไปนี้
URL REST ทั้งหมดสําหรับ API เวอร์ชันหนึ่งๆ (เช่น v20) ใช้คำนำหน้าเวอร์ชัน API เดียวกัน ชื่อและเมธอดของทรัพยากรจะระบุบริการ API ที่กำลังเรียกใช้
Google Ads API ใช้เมธอดที่กําหนดเองอย่างแพร่หลาย ซึ่งต่างจาก REST API แบบดั้งเดิมส่วนใหญ่ที่ใช้เมธอด REST มาตรฐาน เช่น list, get, create, update และ delete ตัวอย่างเมธอดที่กําหนดเองใน Google Ads API ได้แก่ search, searchStream และ mutate
หน้าต่อไปนี้จะอธิบายรายละเอียดเพิ่มเติมเกี่ยวกับชื่อทรัพยากรเมธอดบริการ และแบบแผนการตั้งชื่อ JSON ของ Google Ads API เพื่อแสดงให้เห็นวิธีใช้ร่วมกันเพื่อกําหนดปลายทางอินเทอร์เฟซ REST
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2025-06-04 UTC"],[[["This guide provides Google Ads API implementation details, assuming familiarity with Resource Oriented Design and Resource Names."],["The Google Ads API uses a resource-oriented design with resources organized into collections and accessed using resource names and methods."],["REST URLs in the API consist of an API version prefix, resource name, and method, with custom methods often used."],["Refer to linked resources for further details on resource names, service methods, and JSON naming conventions within the Google Ads API."],["Examples in the guide use HTTP; see the Examples page for `curl` usage."]]],[]]
