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 searchads-api-announcements