การกำหนดเวอร์ชัน
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
คู่มือนี้อธิบายวิธีที่ Merchant API จัดการการกำหนดเวอร์ชัน การเปิดตัว และ
วงจรของเวอร์ชันต่างๆ
รูปแบบการกำหนดเวอร์ชัน
Merchant API ใช้กลยุทธ์การกำหนดเวอร์ชันที่ระดับ API ย่อย ซึ่งหมายความว่า API แต่ละรายการ เช่น ผลิตภัณฑ์ภายใน Merchant API จะมีวงจรเวอร์ชันของตัวเอง
เวอร์ชันย่อยของ API ที่เสถียร: หาก API ย่อยอยู่ในเวอร์ชันเสถียร แสดงว่าเมธอดทั้งหมดของ API ย่อยนั้นอยู่ในเวอร์ชันเสถียร เวอร์ชันย่อยของ API ที่เสถียรจะแสดงเป็น vX (เช่น v1, v2) ซึ่งเป็นเวอร์ชันหลักที่พร้อมใช้งานจริง
เวอร์ชันย่อยของ API ในระดับอัลฟ่า: หาก API ย่อยอยู่ในระดับอัลฟ่า เมธอดทั้งหมดของ API ย่อยนั้นจะอยู่ในระดับอัลฟ่า เวอร์ชันย่อยของ API ระดับอัลฟ่าจะแสดงเป็น
vXalpha (เช่น v1alpha, v2alpha) โดยจะมีฟีเจอร์เวอร์ชันทดลองและฟีเจอร์ทดลองใช้ก่อนเปิดตัวที่มีไว้สำหรับการทดสอบและการทำซ้ำอย่างรวดเร็ว
เวอร์ชันอัลฟ่าไม่มีการรับประกันความเสถียร ไม่มีอายุการใช้งานที่กำหนด
และอาจมีการเปลี่ยนแปลงหรือหยุดให้บริการโดยมีระยะเวลาแจ้งล่วงหน้า 30 วัน
การเปลี่ยนแปลงของเวอร์ชัน
การเพิ่มเวอร์ชันหลัก (เช่น v1 เป็น v2): การเปลี่ยนแปลงเหล่านี้เป็นสัญญาณที่บ่งบอกถึงการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบและไม่สามารถใช้งานร่วมกับเวอร์ชันก่อนหน้าได้ ซึ่งต้องมีการดำเนินการจากนักพัฒนาแอป
เฉพาะการเปลี่ยนแปลงที่ไม่รองรับการทำงานย้อนหลังของ Sub-API ที่เสถียรเท่านั้นที่จะมีหมายเลขเวอร์ชันใหม่ เช่น v1 เป็น v2
การเปลี่ยนแปลงเล็กน้อย: การเพิ่มหรือการแก้ไขที่เข้ากันได้แบบย้อนหลังจะแสดงเป็นการเปลี่ยนแปลงในเวอร์ชันหลักที่มีอยู่ การเปลี่ยนแปลงดังกล่าวจะมีรายละเอียดอยู่ใน
หมายเหตุประจำรุ่นสำหรับเวอร์ชันหลักนั้น การเพิ่มฟีเจอร์ที่ไม่ทำให้เกิดการเปลี่ยนแปลงที่ทำให้ใช้งานร่วมกันไม่ได้ใน API ย่อยจะ
เผยแพร่ในช่องอัลฟ่าของเวอร์ชันเสถียรล่าสุดหรือเผยแพร่ใน
เวอร์ชันเสถียรล่าสุดโดยตรง
นโยบายการหยุดให้บริการ
เราจะเลิกใช้งาน Merchant Sub-API เวอร์ชันเก่าเป็นระยะๆ เราจะให้ระยะเวลาการเลิกใช้งาน 12 เดือน
สำหรับเวอร์ชันหลักที่เสถียร (vX) โดยเริ่มนับจาก
ประกาศการเลิกใช้งานอย่างเป็นทางการ
เช่น หากเราเลิกใช้งาน v1 ของ Products Sub-API ในวันที่ 15 มกราคม 2026 เราจะปิดตัว API ดังกล่าวไม่เร็วกว่าวันที่ 15 มกราคม 2027 หลังจากวันที่ดังกล่าว คุณจะใช้ API ย่อยเวอร์ชันก่อนหน้าไม่ได้อีกต่อไป
เวอร์ชันย่อยของ API และสถานะวงจรการใช้งาน
ตารางต่อไปนี้แสดงเวอร์ชันล่าสุดของ API ย่อยแต่ละรายการของ Merchant API
| Sub-API |
เวอร์ชัน |
สถานะ |
| บัญชี |
v1
v1beta |
ใช้งานอยู่
จะปิดให้บริการในวันที่ 28 ก.พ. 2026 |
| Conversion |
v1
v1beta |
ใช้งานอยู่
จะปิดให้บริการในวันที่ 28 ก.พ. 2026 |
| แหล่งข้อมูล |
v1
v1beta |
ใช้งานอยู่
จะปิดให้บริการในวันที่ 28 ก.พ. 2026 |
| Inventories |
v1
v1beta |
ใช้งานอยู่
จะปิดให้บริการในวันที่ 28 ก.พ. 2026 |
| การแก้ไขปัญหา |
v1
v1beta |
ใช้งานอยู่
จะปิดให้บริการในวันที่ 28 ก.พ. 2026 |
| พาร์ทเนอร์ทางธุรกิจสำหรับฟีดในร้าน |
v1
v1beta |
ใช้งานอยู่
จะปิดให้บริการในวันที่ 28 ก.พ. 2026 |
| การแจ้งเตือน |
v1
v1beta |
ใช้งานอยู่
จะปิดให้บริการในวันที่ 28 ก.พ. 2026 |
| การติดตามคำสั่งซื้อ | v1
v1beta |
ใช้งานอยู่
จะปิดให้บริการในวันที่ 28 ก.พ. 2026 |
| ผลิตภัณฑ์ |
v1
v1beta |
ใช้งานอยู่
จะปิดให้บริการในวันที่ 28 ก.พ. 2026 |
| Product Studio |
v1alpha |
ใช้งานอยู่ |
| โปรโมชัน
|
v1
v1beta |
ใช้งานอยู่
จะปิดให้บริการในวันที่ 28 ก.พ. 2026 |
| โควต้า |
v1
v1beta |
ใช้งานอยู่
จะปิดให้บริการในวันที่ 28 ก.พ. 2026 |
| การรายงาน |
v1
v1beta |
ใช้งานอยู่
จะปิดให้บริการในวันที่ 28 ก.พ. 2026 |
| การตรวจสอบ |
v1alpha
v1 beta |
ใช้งานอยู่
จะปิดให้บริการในวันที่ 28 ก.พ. 2026 |
แนวทางปฏิบัติแนะนำ
- โปรดตรวจสอบบันทึกประจำรุ่นและข้อมูลอัปเดต
ล่าสุดเป็นประจำเพื่อดูเวอร์ชันใหม่ การอัปเดตที่สำคัญ
การปรับปรุง และประกาศเกี่ยวกับการเปิดตัวและการเลิกใช้งาน API ย่อย
- หาก Sub-API มีเวอร์ชันที่เสถียรตั้งแต่ 2 เวอร์ชันขึ้นไป เราขอแนะนำให้ใช้เวอร์ชันล่าสุดอยู่เสมอ
- ออกแบบแอปพลิเคชันให้จัดการข้อผิดพลาดของ Sub-API ต่างๆ ได้อย่างราบรื่น
รวมถึงปัญหาเกี่ยวกับเครือข่าย ขีดจำกัดอัตรา และรหัสหรือข้อความแสดงข้อผิดพลาดใหม่
ที่อาจเกิดขึ้นกับ Sub-API เวอร์ชันใหม่กว่า
- อย่ารอจนกว่าจะถึงเวลาหยุดให้บริการ API เวอร์ชันย่อยจึงเริ่มวางแผน
การอัปเกรด เริ่มประเมินและทดสอบเวอร์ชันใหม่ทันทีที่พร้อมใช้งาน
- หากมีคำขอฟีเจอร์หรือข้อกังวลเกี่ยวกับแผนงานของ Sub-API โปรดติดต่อเรา
พร้อมคำถามหรือความคิดเห็น ดูข้อมูลเกี่ยวกับวิธีติดต่อทีม Merchant API เพื่อขอรับการสนับสนุนด้านเทคนิคได้ที่รับความช่วยเหลือเกี่ยวกับ Merchant API
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-22 UTC
[null,null,["อัปเดตล่าสุด 2025-08-22 UTC"],[],[],null,["# Versioning\n\nThis guide explains how Merchant API handles versioning, releases, and the\nlifecycle of its different versions.\n\nVersioning scheme\n-----------------\n\nMerchant API employs a versioning strategy at the sub-API level. This means that\neach API, for example Products within the Merchant API, will have its own\nversion lifecycle.\n\n### Versioning format and presentation\n\n- **Stable sub-API versions:** If a sub-API is in a stable version then all\n its methods are in a stable version. A stable sub-API version is represented\n as **vX** (for example, **v1** , **v2**). These are production-ready major\n versions.\n\n- **Alpha sub-API versions:** If a sub-API is in an alpha, then all its\n methods are in alpha. An alpha sub-API version is represented as\n **vXalpha** (for example, **v1alpha** , **v2alpha**). They contain\n experimental, early access features intended for testing and rapid\n iteration. Alpha versions come with no stability assurance, have no defined\n lifespan and can be changed or discontinued with a notice period of 30 days.\n\n### Version changes\n\n- **Major version increments** (for example, v1 to v2): These signal\n backward-incompatible and breaking changes, which require developer action.\n Only breaking changes of stable sub-APIs will have a new version number. For\n example, v1 to v2.\n\n- **Minor changes:** Backward compatible additions or fixes are presented as\n changes to the existing major version. Such changes will be detailed in the\n release notes for that major version. Non-breaking additions to a sub-API will\n be released to the alpha channel of the latest stable version or directly to\n the latest stable version.\n\nSunset policy\n-------------\n\nWe periodically sunset older Merchant sub-API versions. We commit to a 12-month\ndeprecation window for stable major versions (vX), starting from the official\ndeprecation announcement.\n\nFor example, if we deprecate v1 of the Products sub-API on January 15, 2026, it\nwill sunset no earlier than January 15, 2027. Beyond this date, the earlier\nversion of the sub-API will no longer be available for use.\n\nSub-API version and lifecycle status\n------------------------------------\n\nThe following table lists the latest versions of each sub-API of Merchant API:\n\n| Sub-API | Versions | Status |\n|-------------------------|----------------|-------------------------------------------|\n| Accounts | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Conversions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Data sources | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Inventories | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Issue resolution | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Local feeds partnership | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Notifications | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Order tracking | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Products | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Product Studio | v1alpha | Active |\n| Promotions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Quota | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reporting | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reviews | v1alpha v1beta | Active To be discontinued on Feb 28, 2026 |\n\nBest practices\n--------------\n\n- Regularly check the release notes and [latest\n updates](/merchant/api/latest-updates) for new versions, major updates, improvements, and announcements about sub-API launches and deprecations.\n- If a sub-API has two or more stable versions, we suggest using the latest version at all times.\n- Design your application to gracefully handle various sub-API errors, including network issues, rate limits, and the new error codes or messages that might be introduced with newer sub-API versions.\n- Don't wait until a sub-API version is about to be sunset to start planning your upgrade. Begin evaluating and testing new versions as soon as they are available.\n- For feature requests or concerns about a sub-API roadmap, [reach out to us\n with questions or feedback](/merchant/api/support/give-feedback). For information about how to contact the Merchant API team for technical support, see [Get help with Merchant API](/merchant/api/support/get-help)."]]
