Управление версиями
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
В этом руководстве объясняется, как Merchant API управляет версиями, выпусками и жизненным циклом различных версий.
Схема управления версиями
API Merchant использует стратегию управления версиями на уровне под-API. Это означает, что каждый API, например, продукты в API Merchant, будет иметь свой собственный жизненный цикл версий.
Стабильные версии под-API: Если под-API находится в стабильной версии, то все его методы также находятся в стабильной версии. Стабильная версия под-API обозначается как vX (например, v1 , v2 ). Это основные версии, готовые к использованию в производстве.
Альфа-версии суб-API: Если суб-API находится в стадии альфа, то все его методы находятся в стадии альфа. Альфа-версия суб-API обозначается как vXalpha (например, v1alpha , v2alpha ). Они содержат экспериментальные функции раннего доступа, предназначенные для тестирования и быстрой итерации. Альфа-версии не гарантируют стабильность, не имеют определённого срока службы и могут быть изменены или прекращены с уведомлением за 30 дней.
Изменения версии
Новые версии (например, с v1 на v2): сигнализируют об обратно несовместимых и критических изменениях, требующих вмешательства разработчика. Только критические изменения стабильных подAPI будут иметь новый номер версии. Например, с v1 на v2.
Незначительные изменения: обратно совместимые дополнения или исправления представлены как изменения к текущей основной версии. Такие изменения будут подробно описаны в примечаниях к выпуску для этой основной версии. Некритичные дополнения к под-API будут выпущены в альфа-канале последней стабильной версии или непосредственно в последней стабильной версии.
Политика заката
Мы периодически прекращаем поддержку старых версий Merchant sub-API. Мы обязуемся установить 12-месячный период прекращения поддержки для стабильных основных версий (vX) с момента официального объявления об прекращении поддержки.
Например, если мы прекратим поддержку v1 под-API Products 15 января 2026 года, то ее действие прекратится не ранее 15 января 2027 года. После этой даты более ранняя версия под-API больше не будет доступна для использования.
Версия Sub-API и статус жизненного цикла
В следующей таблице перечислены последние версии каждого подAPI API Merchant:
| Sub-API | Версии | Статус |
|---|
| Счета | v1
v1beta | Активный
Будет прекращено 28 февраля 2026 г. |
| Конверсии | v1
v1beta | Активный
Будет прекращено 28 февраля 2026 г. |
| Источники данных | v1
v1beta | Активный
Будет прекращено 28 февраля 2026 г. |
| Запасы | v1
v1beta | Активный
Будет прекращено 28 февраля 2026 г. |
| Разрешение проблем | v1
v1beta | Активный
Будет прекращено 28 февраля 2026 г. |
| Партнерство по местным каналам | v1
v1beta | Активный
Будет прекращено 28 февраля 2026 г. |
| Уведомления | v1
v1beta | Активный
Будет прекращено 28 февраля 2026 г. |
| Отслеживание заказа | v1
v1beta | Активный
Будет прекращено 28 февраля 2026 г. |
| Продукты | v1
v1beta | Активный
Будет прекращено 28 февраля 2026 г. |
| Студия продукта | v1alpha | Активный |
| Акции | v1
v1beta | Активный
Будет прекращено 28 февраля 2026 г. |
| Квота | v1
v1beta | Активный
Будет прекращено 28 февраля 2026 г. |
| Отчеты | v1
v1beta | Активный
Будет прекращено 28 февраля 2026 г. |
| Обзоры | v1alpha
v1beta | Активный
Будет прекращено 28 февраля 2026 г. |
Лучшие практики
- Регулярно проверяйте заметки о выпуске и последние обновления на предмет новых версий, крупных обновлений, улучшений и объявлений о запуске и прекращении поддержки суб-API.
- Если у под-API имеется две или более стабильных версий, мы рекомендуем всегда использовать последнюю версию.
- Разработайте свое приложение так, чтобы оно корректно обрабатывало различные ошибки sub-API, включая сетевые неполадки, ограничения скорости и новые коды ошибок или сообщения, которые могут появиться в новых версиях sub-API.
- Не ждите, пока поддержка какой-либо версии API прекратится, чтобы начать планировать обновление. Начинайте оценивать и тестировать новые версии сразу после их появления.
- Если у вас есть вопросы по функциям или вы хотите задать вопрос о дорожной карте под-API, свяжитесь с нами . Информация о том, как связаться с командой Merchant API для получения технической поддержки, приведена в разделе «Получение помощи с Merchant API» .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-09-03 UTC.
[null,null,["Последнее обновление: 2025-09-03 UTC."],[],[],null,["This guide explains how Merchant API handles versioning, releases, and the\nlifecycle of its different versions.\n\nVersioning scheme\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\nVersioning 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\nVersion 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\n will be released to the alpha channel of the latest stable version or\n directly to the latest stable version.\n\nSunset policy\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\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| Reports | 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- 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)."]]
