การกำหนดเวอร์ชันเชิงความหมาย
Google Ads API ใช้การกำหนดเวอร์ชันเชิงความหมายซึ่งมีเวอร์ชันหลักและเวอร์ชันย่อย
รูปแบบของเวอร์ชันคือ MAJOR.MINOR หรือ
vMAJOR_MINOR เช่น v20_0 เป็นเวอร์ชันหลัก ส่วน v20_1 เป็นเวอร์ชันย่อย
ดูบันทึกประจำรุ่นสำหรับเวอร์ชันที่ผ่านมา
เวอร์ชันหลัก
เวอร์ชันที่เผยแพร่ครั้งสำคัญจะมีการเปลี่ยนแปลงบางอย่างที่ส่งผลกับส่วนอื่นในระบบและไม่เข้ากันแบบย้อนหลัง
เวอร์ชันจะลงท้ายด้วย 0 โดยมีรูปแบบ vX_0 ซึ่ง X คือหมายเลขเวอร์ชันหลัก
แต่ละเวอร์ชันหลักจะมีปลายทางแยกกัน ใน URL ตัวอย่างนี้ X คือ
หมายเลขเวอร์ชันหลัก
https://googleads.googleapis.com/vX
หากอัปเกรดจากเวอร์ชันหลักที่เก่ากว่า โค้ดของคุณอาจต้องมีการเปลี่ยนแปลงเมื่อเปลี่ยนไปใช้ปลายทางเวอร์ชันหลักใหม่ หากคุณใช้ไลบรารีของไคลเอ็นต์ของเรา ให้อัปเกรดเป็นเวอร์ชันล่าสุด เมื่อมีการเผยแพร่เวอร์ชันหลัก เราจะจัดทำคู่มือการย้ายข้อมูลที่คุณควรศึกษาเพื่อแก้ไขการเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้องในโค้ด
ตัวอย่างของการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ได้แก่
- การนำออกหรือการเปลี่ยนชื่อบริการ อินเทอร์เฟซ ฟิลด์ เมธอด หรือค่า Enum
- การเปลี่ยนประเภทของฟิลด์
- การเปลี่ยนรูปแบบชื่อทรัพยากร
- การเปลี่ยนรูปแบบ URL ในคำจำกัดความ HTTP
- การเปลี่ยนรูปแบบเอาต์พุต เช่น การเปลี่ยนจาก
0เป็น--เป็นค่าเริ่มต้น - เปลี่ยนเหตุผลของข้อผิดพลาดที่ส่งคืนจาก A เป็น B
เวอร์ชันย่อย
เวอร์ชันย่อยจะมีการเปลี่ยนแปลงที่เข้ากันได้แบบย้อนหลังเท่านั้น สำหรับเวอร์ชันย่อย
vMAJOR_MINOR จะมีหมายเลข MINOR มากกว่า 0
เมื่อมีการเผยแพร่เวอร์ชันย่อย ระบบจะอัปเดตอุปกรณ์ปลายทางที่ใช้งานอยู่โดยอัตโนมัติ การดำเนินการนี้จะไม่ทำให้โค้ดของคุณใช้งานไม่ได้ คุณจะยังใช้ไลบรารีของไคลเอ็นต์ที่มีอยู่ได้
เวอร์ชันย่อยมีฟีเจอร์ใหม่หรือการอัปเดตที่ไม่ส่งผลต่อโค้ดที่มีอยู่ หากต้องการใช้ฟีเจอร์ใหม่เหล่านี้ ให้อัปเกรดไลบรารีของไคลเอ็นต์เป็นเวอร์ชันล่าสุด
พระอาทิตย์ตก
เราจะต้องหยุดให้บริการ Google Ads API เวอร์ชันเก่าเป็นระยะๆ เราจะโพสต์ประกาศ ในบล็อกนักพัฒนาซอฟต์แวร์ เมื่อเวอร์ชันใดเวอร์ชันหนึ่งกำลังจะหยุดให้บริการ เราได้อัปเดตกำหนดการเลิกใช้งานพร้อมวันที่หยุดให้บริการในอนาคต