Search Ads 360 Reporting API ใช้การกําหนดเวอร์ชันแบบเชิงความหมาย
มีเวอร์ชันหลักและเวอร์ชันย่อยซึ่งมีรูปแบบเป็น vMAJOR_MINOR เช่น v0_0 เป็นเวอร์ชันหลักแรกและ v0_1 เวอร์ชันย่อยแรก ส่วนต่อท้ายของหมายเลขเวอร์ชันจะระบุประเภทเวอร์ชัน โดยเวอร์ชันหลักจะมีค่าเป็น 0 เสมอ และเวอร์ชันย่อยจะมีค่ามากกว่า 0 เสมอ
เวอร์ชันหลัก
เวอร์ชันหลักจะมีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ซึ่งก็คือการเปลี่ยนแปลงที่ไม่เข้ากันได้กับเวอร์ชันเก่า
เวอร์ชันหลักแต่ละเวอร์ชันจะมีปลายทางแยกกัน เช่น
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
เมื่ออัปเกรดจากเวอร์ชันหลักเวอร์ชันหนึ่งเป็นเวอร์ชันหลักอีกเวอร์ชันหนึ่ง คุณอาจต้องเปลี่ยนรหัสก่อนเปลี่ยนไปใช้ปลายทางเวอร์ชันหลักใหม่
หากใช้ไลบรารีของไคลเอ็นต์ คุณต้องอัปเกรดเป็นเวอร์ชันล่าสุด เวอร์ชันหลักใหม่จะมีคู่มือการย้ายข้อมูลเพื่อช่วยคุณแก้ไขการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบในโค้ด
ตัวอย่างของการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ได้แก่
- การลบหรือเปลี่ยนชื่อบริการ อินเทอร์เฟซ ช่อง เมธอด หรือค่า enum
- การเปลี่ยนประเภทของฟิลด์
- การเปลี่ยนรูปแบบชื่อทรัพยากร
- การเปลี่ยนรูปแบบ URL ในคําจํากัดความ HTTP
- การเปลี่ยนรูปแบบเอาต์พุต เช่น การเปลี่ยน
0เป็น--เป็นค่าเริ่มต้น - การเปลี่ยนเหตุผลของข้อผิดพลาดที่แสดงจาก A เป็น B
เวอร์ชันย่อย
เวอร์ชันย่อยจะมีเฉพาะการเปลี่ยนแปลงที่เข้ากันได้แบบย้อนหลัง
เมื่อมีการเผยแพร่เวอร์ชันย่อย ระบบจะอัปเดตปลายทางที่ใช้อยู่แล้วโดยอัตโนมัติ ซึ่งจะไม่ทำให้โค้ดใช้งานไม่ได้ คุณใช้คลังไคลเอ็นต์ที่มีอยู่ต่อไปได้
เวอร์ชันย่อยจะมีฟีเจอร์ใหม่หรือการอัปเดตที่ไม่ส่งผลต่อโค้ดที่มีอยู่ หากต้องการใช้ฟีเจอร์ใหม่ คุณต้องอัปเกรดไลบรารีของไคลเอ็นต์เป็นเวอร์ชันล่าสุด
พระอาทิตย์ตก
เมื่อถึงกำหนดเวลาหยุดให้บริการ Search Ads 360 Reporting API เวอร์ชันเก่า เราจะโพสต์ประกาศใน Google Group searchads-api-announcements