Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
В этом руководстве объясняется, как 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 прекратится, чтобы начать планировать обновление. Начинайте оценивать и тестировать новые версии сразу после их появления.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 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)."]]
