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