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