--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/market/partner-api/doc/en/step-by-step/content-change.md - https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/content-change.md - https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/content-change.md - href: ru/step-by-step/content-change.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/ru/llms.txt # Изменение категорийных характеристик Через API можно управлять контентом на карточках товаров — в том числе передавать характеристики, специфические для конкретной категории товаров. ## Товары относятся к новой для магазина категории {#edit-card} ```mermaid %%{ init: { 'theme': 'base', 'themeVariables': { 'primaryColor': '#FDF3E8', 'primaryTextColor': '#000000', 'primaryBorderColor': '#BA9C80', 'lineColor': '#BA9C80', 'secondaryColor': '#94E1C4', 'tertiaryColor': '#F84E57', 'noteBkgColor': '#FED58D' } } }%% sequenceDiagram participant Merchant as Ваш магазин participant Market as Яндекс Маркет rect rgb(251, 243, 232) note right of Merchant: Получение статуса карточек и переданной ранее информации о товарах Merchant ->>+ Market: POST v2/businesses/{businessId}/offer-cards Market ->> Market: Составляет
список товаров. Market -->>- Merchant: OK: список товаров со статусами карточек и рекомендациями по заполнению. end rect rgb(251, 243, 232) note right of Merchant: Получение характеристик товаров, которые необходимы для их категории Merchant ->> Market: Идентификатор категории на Маркете, к которой относится товар
POST v2/category/{categoryId}/parameters Market -->>+ Merchant: OK: список характеристик для товаров данной категории. Merchant ->>- Merchant: Сопоставляет свои характеристики
товаров с характеристиками на Маркете. end rect rgb(251, 243, 232) note right of Merchant: Заполнение карточек Merchant ->>+ Market: Значения характеристик для каждого товара
POST v2/businesses/{businessId}/offer-cards/update Market ->> Market: Анализирует полученный контент
и, если он в порядке,
добавляет его на карточки. Market -->>- Merchant: OK end rect rgb(251, 243, 232) note right of Merchant: Проверка результатов Merchant ->>+ Market: POST v2/businesses/{businessId}/offer-cards Market ->> Market: Проверяет список товаров. Market -->>- Merchant: OK: список товаров со статусами и рекомендациями по заполнению. end ``` 1. Получите информацию, которую вы ранее передавали для карточек товаров, а также статусы карточек и рекомендации по их заполнению с помощью [POST v2/businesses/{businessId}/offer-cards](https://yandex.com/dev/market/partner-api/doc/ru/reference/content/getOfferCardsContentStatus.md). В ответ вы получите следующее: * К каким категориям на Маркете отнесены товары. Маркет определяет категорию товара автоматически на основании предоставленных вами данных. * В каком статусе находятся карточки товаров. * Переданные характеристики товаров. * Рекомендации по заполнению карточек. [Как пользоваться рекомендациями](#recommendations) 2. Для каждой [листовой категории](*list-category) запросите список необходимых характеристик с помощью [POST v2/category/{categoryId}/parameters](https://yandex.com/dev/market/partner-api/doc/ru/reference/content/getCategoryContentParameters.md). Для характеристик, у которых есть единицы измерения, в параметре `unit` вернутся: * допустимые значения (`units`); * значение по умолчанию (`defaultUnitId`). 3. Сопоставьте характеристики, ожидаемые Маркетом, с характеристиками, которые есть в базе данных магазина. **Пример.** Для суповых тарелок Маркет среди прочих ожидает характеристику «Цвет для фильтра». В базе данных магазина та же характеристика называется «Окрас». Вам нужно настроить интеграцию так, чтобы: * значение характеристики «Окрас» передавалось Маркету как характеристика «Цвет для фильтра»; * каждому значению характеристики «Окрас» было сопоставлено допустимое значение характеристики «Цвет для фильтра». 4. Передайте характеристики товаров с помощью [POST v2/businesses/{businessId}/offer-cards/update](https://yandex.com/dev/market/partner-api/doc/ru/reference/content/updateOfferContent.md). {% note warning "Всегда передавайте полный набор характеристик" %} Передача пустых значений сотрет то, что было внесено на карточки ранее. {% endnote %} При необходимости измените идентификатор единицы измерения характеристик — параметр `unitId` в `parameterValues`. Если его не передать, будут использованы единицы измерения по умолчанию (`defaultUnitId`). Перед тем как формировать `parameterValues`, ознакомьтесь с [«Передача значений характеристики»](https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/parameter-values.md) — там описаны типовые случаи, ограничения и примеры. ## Товары относятся к известной и настроенной категории {#known-category} Действуйте по инструкции для новой категории, но пропустите шаг настройки сопоставления характеристик Маркета и магазина. ## Как проверить и обновить сопоставление характеристик на Маркете и в магазине {#check-and-update-comparison} Списки характеристик, требуемых для товаров различных категорий, не остаются неизменными. У гаджетов появляются дополнительные функции, в моду входят новые материалы. Иногда Маркет просто делает более подробным перечень характеристик на карточке товара — чтобы покупателям было удобнее сравнивать и выбирать. Для каждой из настроенных категорий регулярно проверяйте, не нужно ли обновить сопоставление. ```mermaid %%{ init: { 'theme': 'base', 'themeVariables': { 'primaryColor': '#FDF3E8', 'primaryTextColor': '#000000', 'primaryBorderColor': '#BA9C80', 'lineColor': '#BA9C80', 'secondaryColor': '#94E1C4', 'tertiaryColor': '#F84E57', 'noteBkgColor': '#FED58D' } } }%% sequenceDiagram participant Merchant as Ваш магазин participant Market as Яндекс Маркет rect rgb(251, 243, 232) note right of Merchant: Проверка настроек категории Merchant ->> Market: Идентификатор категории на Маркете, которую давно настраивали
POST v2/category/{categoryId}/parameters Market -->>+ Merchant: OK: список характеристик для товаров данной категории. Merchant ->>- Merchant: Проверяет сопоставление характеристик
товаров с характеристиками на Маркете. end ``` {% note tip "Также прочитайте инструкции" %} * [Добавление и редактирование товаров](https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/assortment-add-goods.md) * [Рекомендации Маркета по карточкам](https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/recommendations.md) * [Управление товарами в архиве](https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/assortment-archive.md) {% endnote %} [*list-category]: Категория, у которой нет дочерних.