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