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