การกำหนดเวอร์ชันใน Search Ads 360 Reporting API

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