Lập phiên bản
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Hướng dẫn này giải thích cách Merchant API xử lý việc lập phiên bản, phát hành và vòng đời của các phiên bản.
Lược đồ lập phiên bản
Merchant API sử dụng chiến lược tạo phiên bản ở cấp độ API phụ. Điều này có nghĩa là mỗi API (ví dụ: Sản phẩm trong Merchant API) sẽ có vòng đời phiên bản riêng.
Các phiên bản phụ của API ổn định: Nếu một API phụ ở phiên bản ổn định thì tất cả các phương thức của API đó đều ở phiên bản ổn định. Phiên bản phụ ổn định của API được biểu thị là vX (ví dụ: v1, v2). Đây là các phiên bản chính sẵn sàng phát hành công khai.
Phiên bản phụ của API alpha: Nếu một API phụ ở phiên bản alpha, thì tất cả các phương thức của API đó đều ở phiên bản alpha. Phiên bản phụ alpha của API được biểu thị là vXalpha (ví dụ: v1alpha, v2alpha). Các bản phát hành này chứa các tính năng thử nghiệm, tiếp cận sớm nhằm mục đích kiểm thử và lặp lại nhanh chóng. Các phiên bản alpha không đảm bảo tính ổn định, không có thời gian tồn tại xác định và có thể được thay đổi hoặc ngừng cung cấp trong thời gian thông báo là 30 ngày.
Các lần thay đổi phiên bản
Tăng phiên bản chính (ví dụ: từ v1 lên v2): Những thay đổi này báo hiệu các thay đổi không tương thích ngược và mang tính đột phá, đòi hỏi nhà phát triển phải hành động.
Chỉ những thay đổi có thể gây lỗi của các API phụ ổn định mới có số phiên bản mới. Ví dụ: v1 sang v2.
Thay đổi nhỏ: Các điểm bổ sung hoặc bản sửa lỗi tương thích ngược được trình bày dưới dạng các thay đổi đối với phiên bản chính hiện có. Những thay đổi như vậy sẽ được nêu chi tiết trong ghi chú phát hành của phiên bản chính đó. Các nội dung bổ sung không làm gián đoạn một API phụ sẽ được phát hành cho kênh alpha của phiên bản ổn định mới nhất hoặc trực tiếp cho phiên bản ổn định mới nhất.
Chính sách ngừng hoạt động
Chúng tôi định kỳ ngừng cung cấp các phiên bản cũ của Merchant sub-API. Chúng tôi cam kết có khoảng thời gian ngừng cung cấp là 12 tháng cho các phiên bản chính ổn định (vX), bắt đầu từ thông báo chính thức về việc ngừng cung cấp.
Ví dụ: nếu chúng tôi ngừng sử dụng phiên bản 1 của API con Products vào ngày 15 tháng 1 năm 2026, thì phiên bản này sẽ ngừng hoạt động chậm nhất vào ngày 15 tháng 1 năm 2027. Sau ngày này, bạn sẽ không thể sử dụng phiên bản cũ hơn của API phụ này nữa.
Phiên bản API phụ và trạng thái vòng đời
Bảng sau đây liệt kê các phiên bản mới nhất của từng API phụ trong Merchant API:
| Sub-API |
Phiên bản |
Trạng thái |
| Tài khoản |
v1
v1beta |
Đang hoạt động
Sẽ ngừng hoạt động từ ngày 28 tháng 2 năm 2026 |
| Lượt chuyển đổi |
v1
v1beta |
Đang hoạt động
Sẽ ngừng hoạt động từ ngày 28 tháng 2 năm 2026 |
| Nguồn dữ liệu |
v1
v1beta |
Đang hoạt động
Sẽ ngừng hoạt động từ ngày 28 tháng 2 năm 2026 |
| Khoảng không quảng cáo |
v1
v1beta |
Đang hoạt động
Sẽ ngừng hoạt động từ ngày 28 tháng 2 năm 2026 |
| Giải quyết vấn đề |
v1
v1beta |
Đang hoạt động
Sẽ ngừng hoạt động từ ngày 28 tháng 2 năm 2026 |
| Đối tác nguồn cấp dữ liệu địa phương |
v1
v1beta |
Đang hoạt động
Sẽ ngừng hoạt động từ ngày 28 tháng 2 năm 2026 |
| Thông báo |
v1
v1beta |
Đang hoạt động
Sẽ ngừng hoạt động từ ngày 28 tháng 2 năm 2026 |
| Theo dõi đơn đặt hàng | v1
v1beta |
Đang hoạt động
Sẽ ngừng hoạt động từ ngày 28 tháng 2 năm 2026 |
| Sản phẩm |
v1
v1beta |
Đang hoạt động
Sẽ ngừng hoạt động từ ngày 28 tháng 2 năm 2026 |
| Product Studio |
v1alpha |
Đang hoạt động |
| Khuyến mãi
|
v1
v1beta |
Đang hoạt động
Sẽ ngừng hoạt động từ ngày 28 tháng 2 năm 2026 |
| Hạn mức |
v1
v1beta |
Đang hoạt động
Sẽ ngừng hoạt động từ ngày 28 tháng 2 năm 2026 |
| Báo cáo |
v1
v1beta |
Đang hoạt động
Sẽ ngừng hoạt động từ ngày 28 tháng 2 năm 2026 |
| Bài đánh giá |
v1alpha
v1 beta |
Đang hoạt động
Sẽ ngừng hoạt động từ ngày 28 tháng 2 năm 2026 |
Các phương pháp hay nhất
- Thường xuyên kiểm tra ghi chú phát hành và thông tin cập nhật mới nhất để biết các phiên bản mới, bản cập nhật lớn, điểm cải tiến và thông báo về việc ra mắt cũng như ngừng sử dụng API phụ.
- Nếu một API phụ có từ 2 phiên bản ổn định trở lên, bạn nên luôn sử dụng phiên bản mới nhất.
- Thiết kế ứng dụng của bạn để xử lý linh hoạt nhiều lỗi API phụ, bao gồm cả các vấn đề về mạng, giới hạn về tốc độ và mã lỗi hoặc thông báo lỗi mới có thể xuất hiện trong các phiên bản API phụ mới hơn.
- Đừng đợi đến khi phiên bản phụ của API sắp ngừng hoạt động mới bắt đầu lên kế hoạch nâng cấp. Bắt đầu đánh giá và kiểm thử các phiên bản mới ngay khi chúng có sẵn.
- Nếu bạn có yêu cầu về tính năng hoặc lo ngại về lộ trình của một API phụ, hãy liên hệ với chúng tôi để đặt câu hỏi hoặc gửi ý kiến phản hồi. Để biết thông tin về cách liên hệ với nhóm Merchant API để được hỗ trợ kỹ thuật, hãy xem bài viết Yêu cầu trợ giúp về Merchant API.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-22 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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)."]]
