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