การกำหนดเวอร์ชันแบบความหมาย
Google Ads API ใช้การกำหนดเวอร์ชันตามความหมายซึ่งมีเวอร์ชันหลักและเวอร์ชันย่อย รูปแบบของเวอร์ชันคือ MAJOR.MINOR หรือ
vMAJOR_MINOR ตัวอย่างเช่น v18_0 เป็นเวอร์ชันหลัก ส่วน v18_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 เวอร์ชันเก่าจะต้องหยุดให้บริการเป็นระยะๆ เราจะโพสต์ประกาศในบล็อกนักพัฒนาซอฟต์แวร์เมื่อเวอร์ชันหนึ่งใกล้จะหยุดให้บริการ กำหนดการเลิกใช้งานจะอัปเดตวันที่หยุดให้บริการในอนาคต