--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://yandex.com/dev/market/partner-api/doc/en/reference/business-offer-mappings/updateOfferMappings.md - https://yandex.com/dev/market/partner-api/doc/ru/reference/business-offer-mappings/updateOfferMappings.md - https://yandex.com/dev/market/partner-api/doc/zh/reference/business-offer-mappings/updateOfferMappings.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/zh/llms.txt
# 将产品添加到目录并更改有关它们的信息 {% list tabs %} - Info **方法适用于[所有模式](https://yandex.com/dev/market/partner-api/doc/zh/overview/business.md).** {% cut "**如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一**" %} * offers-and-cards-management — [商品和卡片管理](https://yandex.com/dev/market/partner-api/doc/zh/_auto/scopes_summary/pages/offers-and-cards-management.md) * all-methods — 全面管理账户 {% endcut %} 将产品添加到目录并传输: * 他们的 [叶子类别](*list-categories) 关于市场和分类特征; * 主要特点; * 商品在橱柜的价格。 它还结合卡上的产品，编辑和删除有关已添加产品的信息，包括机柜和产品类别中的价格。 您可以使用请求获取市场类别列表。 [POST v2/categories/tree](https://yandex.com/dev/market/partner-api/doc/zh/reference/categories/getCategoriesTree.md)，以及按类别使用的产品特性 [POST v2/category/{categoryId}/parameters](https://yandex.com/dev/market/partner-api/doc/zh/reference/content/getCategoryContentParameters.md). {% cut "Добавить новый товар" %} 使用以前从未在文件夹中使用过的新ID传输它。 请务必指定参数: `offerId`, `name`, `marketCategoryId`, `pictures`, `vendor`, `description`. 尝试一次传达尽可能多的信息 — 市场将需要它来选择合适的卡或创建一个新的。 如果您知道市场上的哪张卡对应的产品，您可以立即指定此卡的ID（SKU 在市场上）在现场 `marketSKU`. **对于Yandex Go市场的卖家:** 将产品添加到目录时，请指定参数值 `name` 和 `description` 用俄语。 要在展柜上以不同的语言显示它们，请再次提出请求。 `POST v2/businesses/{businessId}/offer-mappings/update` 在哪里指定: * 参数中的语言 `language`; * 参数值 `name` 和 `description` 在指定的语言。 不需要重传剩余的产品特性。 {% endcut %} {% cut "Изменить информацию о товаре" %} 通过指定in发送新数据 `offerId` SKU 产品在您的系统中。 可以省略任何更改的字段。 {% endcut %} {% cut "Удалить переданные ранее параметры товара" %} 在 `deleteParameters` 指定要删除的参数的值。 您可以一次传递多个值。 对于具有类型的参数 `string` 您也可以传递空值。 {% endcut %} 参数 `offerId` (SKU 您系统中的产品）必须是 **独特的** 对于您转移的所有产品。 {% note warning "Правила использования SKU" %} * 对于每个产品 SKU 一定有一个。 * 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。 SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 [在市场对卖家的帮助](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku). {% endnote %} {% note info "Данные в каталоге обновляются не мгновенно" %} 最多需要几分钟。 {% endnote %} |
**⚙️ 没有订阅的限制:** 5 000 产品 每分钟
**⭐️ [使用中等订阅限制](https://yandex.ru/support/marketplace/ru/marketing/subscription):** 10 000 产品 每分钟
| |-| ## Request
POST {.openapi__method} ```text translate=no https://api.partner.market.yandex.ru/v2/businesses/{businessId}/offer-mappings/update ```
### Path parameters #| || **Name** | **Description** || || _businessId_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: integer 内阁ID。 _Min value:_{.json-schema-reset .json-schema-assertion} `1` {.table-cell} || |#{.json-schema-properties} ### Query parameters #| || **Name** | **Description** || || _language_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 接受和返回参数中的值的语言 `name` 和 `description`. 默认值: `RU`. 语言: * `RU` — 俄语。 * `UZ` — 乌兹别克。 _Enum:_{.json-schema-reset .json-schema-value} `RU`, `UZ` {.table-cell} || |#{.json-schema-properties}
### Body {% cut "application/json" %} ```json translate=no { "offerMappings": [ { "offer": { "offerId": "example", "name": "Ударная дрель Makita HP1630, 710 Вт", "marketCategoryId": 0, "category": "example", "pictures": [ null ], "videos": [ null ], "manuals": [ null ], "vendor": "LEVENHUK", "barcodes": [ null ], "description": "example", "manufacturerCountries": [ null ], "weightDimensions": {}, "vendorCode": "VNDR-0005A", "tags": [ null ], "shelfLife": {}, "lifeTime": {}, "guaranteePeriod": {}, "customsCommodityCode": "8517610008", "commodityCodes": [ null ], "certificates": [ null ], "boxCount": 1, "condition": {}, "type": "DEFAULT", "downloadable": true, "adult": true, "age": {}, "params": [ null ], "parameterValues": [ null ], "basicPrice": {}, "purchasePrice": {}, "additionalExpenses": {}, "firstVideoAsCover": true, "deleteParameters": [ null ] }, "mapping": { "marketSku": 1 } } ], "onlyPartnerMediaContent": true } ``` {% endcut %} #| || **Name** | **Description** || || _offerMappings_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| {% cut "**Type**: object[]" %} #| || _offer_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: object {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and} - **Type**: object #| || _offerId_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 你的 SKU — 系统中的产品ID。 使用规则 SKU: * 对于每个产品 SKU 一定有一个。 * 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。 SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 [在市场对卖家的帮助](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku). {% note warning %} 值开头和结尾的空格会自动删除。 例如, `" SKU123 "` 和 `"SKU123"` 它们将被视为相同的值。 {% endnote %} [什么是 SKU 以及如何分配它](https://yandex.ru/support/marketplace/assortment/add/index.html#fields) _Min length:_{.json-schema-reset .json-schema-assertion} `1` _Max length:_{.json-schema-reset .json-schema-assertion} `255` _Pattern:_{.json-schema-reset .json-schema-assertion} `^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$` _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _adult_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: boolean 该参数包括产品的标签18+。 仅将其设置为与满足性需求相关的产品。 {.table-cell} || || _age_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object" %} #| || _ageUnit_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 年龄测量单位: * `YEAR` — 年。 * `MONTH` — 月份。 _Enum:_{.json-schema-reset .json-schema-value} `YEAR`, `MONTH` {.table-cell} || || _value_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: number 意义。 _Min value:_{.json-schema-reset .json-schema-assertion} `0` {.table-cell} || |#{.json-schema-properties} {% endcut %} 年龄在指定的测量单位。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "value": 0, "ageUnit": "YEAR" } ``` {% endcut %} {.table-cell} || || _barcodes_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string[] | null 条形码。 将其指定为数字序列。 密码可以 EAN-13, EAN-8, UPC-A, UPC-E 或 Code 128. 对于书籍 — ISBN. 对于产品 [某些类别和品牌](https://yastatic.net/s3/doc-binary/src/support/market/ru/yandex-market-list-for-gtin.xlsx) 条形码必须是有效的代码。 GTIN. 请注意：内部条码以2或02开头，以及格式代码 Code 128 他们不是 GTIN. 【是什么 GTIN](*gtin) _Min items:_{.json-schema-reset .json-schema-assertion} `1` _Unique items:_{.json-schema-reset .json-schema-assertion} `true` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ "46012300000000" ] ``` {% endcut %} {.table-cell} || || _boxCount_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: integer 货位的数量。 如果产品由多个盒子、包装等组成，则使用此参数。 例如，空调占用两个座位 — 外部和内部单元在两个盒子里。 对于占据一个位置的产品，不要传递此参数。 _Min value:_{.json-schema-reset .json-schema-assertion} `1` {.table-cell} || || _category_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact} {.table-cell}| **Type**: string {% note warning "Вместо него используйте `marketCategoryId`." %}   {% endnote %} 您商店中的产品类别。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _certificates_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string[] | null 产品文件的编号:证书、符合性声明等. 你只可透过以下途径传送文件编号，而文件编号的扫描件已上载于商户的办公室 [指示说明](https://yandex.ru/support/marketplace/assortment/restrictions/certificates.html). _Min items:_{.json-schema-reset .json-schema-assertion} `1` _Max items:_{.json-schema-reset .json-schema-assertion} `6` _Unique items:_{.json-schema-reset .json-schema-assertion} `true` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ "example" ] ``` {% endcut %} {.table-cell} || || _commodityCodes_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _code_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 产品代码。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _type_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 产品代码类型: * `CUSTOMS_COMMODITY_CODE` — 对外经济活动统一商品命名法（HS）中的产品代码 — 没有空格的10或14位数字。 * `IKPU_CODE` — 乌兹别克斯坦产品和服务的识别码为17位数字，无空格。 不要发送相同类型的多个代码。 _Enum:_{.json-schema-reset .json-schema-value} `CUSTOMS_COMMODITY_CODE`, `IKPU_CODE` {.table-cell} || |#{.json-schema-properties} {% endcut %} 产品代码。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "code": "example", "type": "CUSTOMS_COMMODITY_CODE" } ] ``` {% endcut %} {.table-cell} || || _condition_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object" %} #| || _quality_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 产品外观: * `PERFECT` — 理想。 * `EXCELLENT` — 善乎哉！. * `GOOD` — 好。 * `NOT_SPECIFIED` — 未被选中。 _Enum:_{.json-schema-reset .json-schema-value} `PERFECT`, `EXCELLENT`, `GOOD`, `NOT_SPECIFIED` {.table-cell} || || _reason_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 产品说明。 详细描述缺陷，它们的明显程度以及在哪里寻找它们。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _type_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 标记类型: * `PREOWNED` — 曾经属于另一个人的二手货。 * `SHOWCASESAMPLE` — 展示样品。 * `REFURBISHED` — 产品的再销售。 * `REDUCTION` — 产品有缺陷。 * `RENOVATED` — 的还原产物。 * `NOT_SPECIFIED` — 未被选中。 `REFURBISHED` — 衣服，鞋子和配饰的特殊价值。 它仅用于此类别的折扣产品。 不使用服装、鞋和配件的其他值。 _Enum:_{.json-schema-reset .json-schema-value} `PREOWNED`, `SHOWCASESAMPLE`, `REFURBISHED`, `REDUCTION`, `RENOVATED`, `NOT_SPECIFIED` {.table-cell} || |#{.json-schema-properties} {% endcut %} 折扣产品的状况。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "type": "PREOWNED", "quality": "PERFECT", "reason": "example" } ``` {% endcut %} {.table-cell} || || _customsCommodityCode_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact} {.table-cell}| **Type**: string {% note warning "Вместо него используйте `commodityCodes` с типом `CUSTOMS_COMMODITY_CODE`." %}   {% endnote %} 对外经济活动统一商品命名法（HS）中的产品代码 — 没有空格的10或14位数字。 一定要指出是否有。 _Example:_{.json-schema-reset .json-schema-example} `8517610008` {.table-cell} || || _description_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 详细的产品说明：例如，它的优点和特点。 说明中不提供安装和装配说明。 不要使用"折扣"，"销售"，"便宜"，"礼品"（礼品类别除外），"免费"，"特价"，"特价"，"新奇"，"新"，"模拟"，"订单"，"点击"等字样。 不要提供任何联系信息或链接。 HTML标签可用于格式化文本: * \，\

，\

等等 — 新闻标题; * \
和\

— 对于换行符; * \

    — 对于编号列表; * \
      — 对于项目符号列表。 * \<李> — 创建列表项（必须在\
        或\
          内）; * \
          — 支持，但不影响文本显示。 最佳长度 — 400-600个字符。 [建议和规则](https://yandex.ru/support/marketplace/assortment/fields/description.html) _Max length:_{.json-schema-reset .json-schema-assertion} `6000` _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _downloadable_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: boolean 数字产品的标志。 指定 `true` 如果产品是通过电子邮件交付的。 [如何使用数字商品](https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/digital.md) {.table-cell} || || _guaranteePeriod_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object" %} #| || _timePeriod_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: integer 指定单位的持续时间。 {.table-cell} || || _timeUnit_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 时间测量单元: * `HOUR` — 小时。 * `DAY` — 一天。 * `WEEK` — 一个星期。 * `MONTH` — 月份。 * `YEAR` — 年。 _Enum:_{.json-schema-reset .json-schema-value} `HOUR`, `DAY`, `WEEK`, `MONTH`, `YEAR` {.table-cell} || || _comment_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 评论。 _Max length:_{.json-schema-reset .json-schema-assertion} `500` _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || |#{.json-schema-properties} {% endcut %} 带有注释的时间段。 注释内容的要求取决于参数用法的上下文，并在包含它的字段的描述中指定。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "timePeriod": 0, "timeUnit": "HOUR", "comment": "example" } ``` {% endcut %} {.table-cell} || || _lifeTime_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object" %} #| || _timePeriod_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: integer 指定单位的持续时间。 {.table-cell} || || _timeUnit_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 时间测量单元: * `HOUR` — 小时。 * `DAY` — 一天。 * `WEEK` — 一个星期。 * `MONTH` — 月份。 * `YEAR` — 年。 _Enum:_{.json-schema-reset .json-schema-value} `HOUR`, `DAY`, `WEEK`, `MONTH`, `YEAR` {.table-cell} || || _comment_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 评论。 _Max length:_{.json-schema-reset .json-schema-assertion} `500` _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || |#{.json-schema-properties} {% endcut %} 带有注释的时间段。 注释内容的要求取决于参数用法的上下文，并在包含它的字段的描述中指定。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "timePeriod": 0, "timeUnit": "HOUR", "comment": "example" } ``` {% endcut %} {.table-cell} || || _manuals_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _url_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string _Min length:_{.json-schema-reset .json-schema-assertion} `1` _Max length:_{.json-schema-reset .json-schema-assertion} `2000` _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _title_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 将显示在产品卡上的指令的名称。 _Max length:_{.json-schema-reset .json-schema-assertion} `500` _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || |#{.json-schema-properties} {% endcut %} 有关如何使用产品的说明列表。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` _Max items:_{.json-schema-reset .json-schema-assertion} `6` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "url": "example", "title": "example" } ] ``` {% endcut %} {.table-cell} || || _manufacturerCountries_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string[] | null 产品生产的国家。 写下这些国家的名字，因为它们是写在 [名单](https://yastatic.net/s3/doc-binary/src/support/market/ru/countries.xlsx). _Min items:_{.json-schema-reset .json-schema-assertion} `1` _Unique items:_{.json-schema-reset .json-schema-assertion} `true` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ "Россия" ] ``` {% endcut %} {.table-cell} || || _marketCategoryId_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: integer 您将产品归因于市场上类别的ID。 {% note warning "Всегда указывайте, когда передаете `parameterValues`" %} 如果，在改变特征时，通过 `parameterValues` 并且不指定 `marketCategoryId`，特征将被更新，但您将在响应中收到警告（参数 `warnings`). 如果您不传递这两个参数，则将使用来自过时参数的信息。 `params` 和 `category`，而 `marketCategoryId` 它将被自动检测到。 {% endnote %} 更改类别时，请确保参数中的产品特性及其值 `parameterValues` 您正在提交一个新的类别. 您可以使用请求获取市场类别列表。 [POST v2/categories/tree](https://yandex.com/dev/market/partner-api/doc/zh/reference/categories/getCategoriesTree.md). _Min value:_{.json-schema-reset .json-schema-assertion} `0` _Exclusive min:_{.json-schema-reset .json-schema-assertion} `true` {.table-cell} || || _name_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 根据方案组成名称：类型+品牌或制造商+型号+功能，如果有的话（例如，颜色，尺寸或重量）和数量在包装中。 不包括情感特征（"命中"，"超级"等。）以销售条款的名义（例如，"折扣"，"免费送货"等。). 不要用大写字母写单词。 — 除了成熟的品牌名称和型号。 最佳长度 — 50-60个字符。 [建议和规则](https://yandex.ru/support/marketplace/assortment/fields/title.html) _Max length:_{.json-schema-reset .json-schema-assertion} `256` _Example:_{.json-schema-reset .json-schema-example} `Ударная дрель Makita HP1630, 710 Вт` {.table-cell} || || _params_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact} {.table-cell}| {% cut "**Type**: object[]" %} #| || _name_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 特性的名称。 它必须与市场上的功能名称相匹配。 您可以从类别的Excel模板或通过查询找到它。 [POST v2/category/{categoryId}/parameters](https://yandex.com/dev/market/partner-api/doc/zh/reference/content/getCategoryContentParameters.md). _Max length:_{.json-schema-reset .json-schema-assertion} `200` _Example:_{.json-schema-reset .json-schema-example} `Wi-Fi` {.table-cell} || || _value_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 意义。 _Example:_{.json-schema-reset .json-schema-example} `есть` {.table-cell} || |#{.json-schema-properties} {% endcut %} {% note warning "При передаче характеристик используйте `parameterValues`." %}   {% endnote %} 只有特定类别的产品才具有的特性。 — 例如，自行车车轮的直径或鞋底的材料。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "name": "Wi-Fi", "value": "есть" } ] ``` {% endcut %} {.table-cell} || || _pictures_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string[] | null 产品图片的链接。 第一个链接上的图像被认为是主要的，其他的是额外的。 **连结要求** * 指定整个链接，包括http或https协议。 * 俄文字母 URL 阿美。 * 您可以使用直接链接到图像和Yandex的。磁盘。 Yandex上的链接。必须使用函数**共享**复制磁盘。 与其他云存储的相对链接和链接 — 它们不起作用。 ✅ `https://example-shop.ru/images/sku12345.jpg` ✅ `https://yadi.sk/i/NaBoRsimVOLov` ❌ `/images/sku12345.jpg` ❌ `https://www.dropbox.com/s/818f/tovar.jpg` 与图像的链接必须是永久性的。 不能使用从上载更改为上载的动态链接。 如果您需要替换图像，请通过新链接上传新图像，并删除到旧图像的链接。 如果您只是从旧链接替换图像，它将不会更新。 [图像要求](https://yandex.ru/support/marketplace/assortment/fields/images.html) _Min items:_{.json-schema-reset .json-schema-assertion} `1` _Max items:_{.json-schema-reset .json-schema-assertion} `30` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ "example" ] ``` {% endcut %} {.table-cell} || || _shelfLife_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object" %} #| || _timePeriod_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: integer 指定单位的持续时间。 {.table-cell} || || _timeUnit_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 时间测量单元: * `HOUR` — 小时。 * `DAY` — 一天。 * `WEEK` — 一个星期。 * `MONTH` — 月份。 * `YEAR` — 年。 _Enum:_{.json-schema-reset .json-schema-value} `HOUR`, `DAY`, `WEEK`, `MONTH`, `YEAR` {.table-cell} || || _comment_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 评论。 _Max length:_{.json-schema-reset .json-schema-assertion} `500` _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || |#{.json-schema-properties} {% endcut %} 带有注释的时间段。 注释内容的要求取决于参数用法的上下文，并在包含它的字段的描述中指定。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "timePeriod": 0, "timeUnit": "HOUR", "comment": "example" } ``` {% endcut %} {.table-cell} || || _tags_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string[] | null 商店使用的产品标签。 标签对客户不可见。 您可以按标签对目录中的不同产品进行分组和筛选。 — 例如，同一系列、系列或系列的产品。 最大标签长度 — 20个字符。 一个产品最多可以有10个标签. _Min items:_{.json-schema-reset .json-schema-assertion} `1` _Max items:_{.json-schema-reset .json-schema-assertion} `50` _Unique items:_{.json-schema-reset .json-schema-assertion} `true` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ "до 500 рублей" ] ``` {% endcut %} {.table-cell} || || _type_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 特殊类型的产品: * `DEFAULT` — 产品，你以前提供了一个特殊的类型，并希望将其删除。 * `MEDICINE` — 药品。 * `BOOK` — 纸质和电子书。 * `AUDIOBOOK` — 有声读物。 * `ARTIST_TITLE` — 音乐和视频制作。 * `ON_DEMAND` — 定制产品。 * `ALCOHOL` — 酒精。 {% note info "Если ваш товар — книга" %} 在产品规格中指定发布年份。 [有关参数的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/reference/business-offer-mappings/updateOfferMappings.md#offerparamdto) {% endnote %} _Enum:_{.json-schema-reset .json-schema-value} `DEFAULT`, `MEDICINE`, `BOOK`, `AUDIOBOOK`, `ARTIST_TITLE`, `ON_DEMAND`, `ALCOHOL` {.table-cell} || || _vendor_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 品牌或制造商的名称。 它应该按照品牌本身的方式编写。 _Example:_{.json-schema-reset .json-schema-example} `LEVENHUK` {.table-cell} || || _vendorCode_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 从制造商的产品的文章。 _Example:_{.json-schema-reset .json-schema-example} `VNDR-0005A` {.table-cell} || || _videos_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string[] | null 连结(URL）上的产品视频。 **连结要求** * 指定整个链接，包括http或https协议。 * 俄文字母 URL 阿美。 * 您可以使用视频和Yandex的直接链接。磁盘。 Yandex上的链接。必须使用函数**共享**复制磁盘。 与其他云存储的相对链接和链接 — 它们不起作用。 ✅ `https://example-shop.ru/video/sku12345.avi` ✅ `https://yadi.sk/i/NaBoRsimVOLov` ❌ `/video/sku12345.avi` ❌ `https://www.dropbox.com/s/818f/super-tovar.avi` 视频链接必须是永久性的。 不能使用从上载更改为上载的动态链接。 如果您需要更换视频，请通过新链接上传新视频，并删除旧视频的链接。 如果您只是使用旧链接替换视频，它将不会更新。 [视频要求](https://yandex.ru/support/marketplace/assortment/fields/video.html) _Min items:_{.json-schema-reset .json-schema-assertion} `1` _Max items:_{.json-schema-reset .json-schema-assertion} `6` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ "example" ] ``` {% endcut %} {.table-cell} || || _weightDimensions_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object" %} #| || _height_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: number 包装高度以厘米为单位。 _Min value:_{.json-schema-reset .json-schema-assertion} `0` {.table-cell} || || _length_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: number 包装长度以厘米为单位。 _Min value:_{.json-schema-reset .json-schema-assertion} `0` {.table-cell} || || _weight_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: number 以公斤为单位的产品重量，包括包装（毛）。 _Min value:_{.json-schema-reset .json-schema-assertion} `0` {.table-cell} || || _width_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: number 包装宽度以厘米为单位。 _Min value:_{.json-schema-reset .json-schema-assertion} `0` {.table-cell} || |#{.json-schema-properties} {% endcut %} 包装的尺寸和产品的重量。 如果产品占用几个盒子，在测量尺寸之前将它们紧凑地折叠起来。 ![多座位货物测量方案](../../_images/reference/boxes-measure.png) {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "length": 65.55, "width": 50.7, "height": 20, "weight": 1.001 } ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} 产品的主要参数。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "offerId": "example", "name": "Ударная дрель Makita HP1630, 710 Вт", "marketCategoryId": 0, "category": "example", "pictures": [ "example" ], "videos": [ "example" ], "manuals": [ { "url": "example", "title": "example" } ], "vendor": "LEVENHUK", "barcodes": [ "46012300000000" ], "description": "example", "manufacturerCountries": [ "Россия" ], "weightDimensions": { "length": 65.55, "width": 50.7, "height": 20, "weight": 1.001 }, "vendorCode": "VNDR-0005A", "tags": [ "до 500 рублей" ], "shelfLife": { "timePeriod": 0, "timeUnit": "HOUR", "comment": "example" }, "lifeTime": { "timePeriod": 0, "timeUnit": "HOUR", "comment": "example" }, "guaranteePeriod": { "timePeriod": 0, "timeUnit": "HOUR", "comment": "example" }, "customsCommodityCode": "8517610008", "commodityCodes": [ { "code": "example", "type": "CUSTOMS_COMMODITY_CODE" } ], "certificates": [ "example" ], "boxCount": 1, "condition": { "type": "PREOWNED", "quality": "PERFECT", "reason": "example" }, "type": "DEFAULT", "downloadable": true, "adult": true, "age": { "value": 0, "ageUnit": "YEAR" }, "params": [ { "name": "Wi-Fi", "value": "есть" } ] } ``` {% endcut %} - **Type**: object #| || _additionalExpenses_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object" %} #| || _currencyId_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 货币代码: * `RUR` — 俄罗斯卢布。 * `UAH` — 乌克兰格里夫纳。 * `BYR` — 白俄罗斯卢布。 * `KZT` — 哈萨克斯坦坚戈。 * `UZS` — 乌兹别克总和。 _Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE` {.table-cell} || || _value_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: number 品的价格。 _Min value:_{.json-schema-reset .json-schema-assertion} `0` _Exclusive min:_{.json-schema-reset .json-schema-assertion} `true` {.table-cell} || |#{.json-schema-properties} {% endcut %} 品的价格。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "value": 0, "currencyId": "RUR" } ``` {% endcut %} {.table-cell} || || _basicPrice_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: object {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and} - **Type**: object #| || _currencyId_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 货币代码: * `RUR` — 俄罗斯卢布。 * `UAH` — 乌克兰格里夫纳。 * `BYR` — 白俄罗斯卢布。 * `KZT` — 哈萨克斯坦坚戈。 * `UZS` — 乌兹别克总和。 _Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE` {.table-cell} || || _value_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: number 品的价格。 _Min value:_{.json-schema-reset .json-schema-assertion} `0` _Exclusive min:_{.json-schema-reset .json-schema-assertion} `true` {.table-cell} || |#{.json-schema-properties} 品的价格。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "value": 0, "currencyId": "RUR" } ``` {% endcut %} - **Type**: object #| || _discountBase_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: number 划掉的价格。 数字必须是整数。 您可以指定折扣从5到99％的价格。 如果您提供产品折扣，则在每次更新价格时传递此参数。 _Min value:_{.json-schema-reset .json-schema-assertion} `0` _Exclusive min:_{.json-schema-reset .json-schema-assertion} `true` {.table-cell} || |#{.json-schema-properties} {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "discountBase": 0 } ``` {% endcut %} {% endcut %} 价格与折扣指示. {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "value": 0, "currencyId": "RUR", "discountBase": 0 } ``` {% endcut %} {.table-cell} || || _deleteParameters_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string[] | null 您之前传递给的参数 `UpdateOfferDTO`，现在你想删除它。 如果您发送 `adult`, `downloadable` 和 `firstVideoAsCover` 它们不会被删除 — 它们的值将变为 `false`. 您可以一次传递多个值。 不要与相应的参数一起使用 `UpdateOfferDTO`. 这将导致错误。 `400`. _Min items:_{.json-schema-reset .json-schema-assertion} `1` _Unique items:_{.json-schema-reset .json-schema-assertion} `true` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ "ADDITIONAL_EXPENSES" ] ``` {% endcut %} {.table-cell} || || _firstVideoAsCover_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact} {.table-cell}| **Type**: boolean 使用卡中的第一个视频作为视频背景。 传下去 `true` 为第一视频作为视频背景，或 `false` 使视频背景不显示在产品配置文件中。 {.table-cell} || || _parameterValues_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _parameterId_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: integer 特性的标识符。 _Min value:_{.json-schema-reset .json-schema-assertion} `1` {.table-cell} || || _unitId_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: integer 测量单位的ID。 如果没有传递参数 `unitId`，使用默认的测量单位。 {.table-cell} || || _value_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 意义。 对于类型特征 `ENUM` 发送: - 与 `valueId`，如果从目录取值; - 没有 `valueId`，如果值是它自己的。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _valueId_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: integer 值的ID。 - 如果要从从市场接收的可接受值列表中传输值，请务必指定标识符。 - 不要为自己的值指定。 - 仅针对类型特征 `ENUM`. {.table-cell} || |#{.json-schema-properties} {% endcut %} 具有其值的特征列表。 {% note warning "Всегда передавайте вместе с `marketCategoryId`" %} 如果你不通过它 `marketCategoryId` 当特征发生变化时，它们将被更新，但在响应中会收到警告（参数 `warnings`). 如果您不传递这两个参数，则将使用来自过时参数的信息。 `params` 和 `category`，而 `marketCategoryId` 它将被自动检测到。 {% endnote %} 当**改变**特性时，仅传送其值需要更新的那些。 如果在 `marketCategoryId` 您正在更改类别，新旧类别的共同特征的值将保留，并且您不需要转移它们。 阅读更多 ["特性值的传递"](https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/parameter-values.md). _Min items:_{.json-schema-reset .json-schema-assertion} `1` _Max items:_{.json-schema-reset .json-schema-assertion} `300` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "parameterId": 1, "unitId": 0, "valueId": 0, "value": "example" } ] ``` {% endcut %} {.table-cell} || || _purchasePrice_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object" %} #| || _currencyId_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 货币代码: * `RUR` — 俄罗斯卢布。 * `UAH` — 乌克兰格里夫纳。 * `BYR` — 白俄罗斯卢布。 * `KZT` — 哈萨克斯坦坚戈。 * `UZS` — 乌兹别克总和。 _Enum:_{.json-schema-reset .json-schema-value} `RUR`, `USD`, `EUR`, `UAH`, `AUD`, `GBP`, `BYR`, `BYN`, `DKK`, `ISK`, `KZT`, `CAD`, `CNY`, `NOK`, `XDR`, `SGD`, `TRY`, `SEK`, `CHF`, `JPY`, `AZN`, `ALL`, `DZD`, `AOA`, `ARS`, `AMD`, `AFN`, `BHD`, `BGN`, `BOB`, `BWP`, `BND`, `BRL`, `BIF`, `HUF`, `VEF`, `KPW`, `VND`, `GMD`, `GHS`, `GNF`, `HKD`, `GEL`, `AED`, `EGP`, `ZMK`, `ILS`, `INR`, `IDR`, `JOD`, `IQD`, `IRR`, `YER`, `QAR`, `KES`, `KGS`, `COP`, `CDF`, `CRC`, `KWD`, `CUP`, `LAK`, `LVL`, `SLL`, `LBP`, `LYD`, `SZL`, `LTL`, `MUR`, `MRO`, `MKD`, `MWK`, `MGA`, `MYR`, `MAD`, `MXN`, `MZN`, `MDL`, `MNT`, `NPR`, `NGN`, `NIO`, `NZD`, `OMR`, `PKR`, `PYG`, `PEN`, `PLN`, `KHR`, `SAR`, `RON`, `SCR`, `SYP`, `SKK`, `SOS`, `SDG`, `SRD`, `TJS`, `THB`, `TWD`, `BDT`, `TZS`, `TND`, `TMM`, `UGX`, `UZS`, `UYU`, `PHP`, `DJF`, `XAF`, `XOF`, `HRK`, `CZK`, `CLP`, `LKR`, `EEK`, `ETB`, `RSD`, `ZAR`, `KRW`, `NAD`, `TL`, `UE` {.table-cell} || || _value_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: number 品的价格。 _Min value:_{.json-schema-reset .json-schema-assertion} `0` _Exclusive min:_{.json-schema-reset .json-schema-assertion} `true` {.table-cell} || |#{.json-schema-properties} {% endcut %} 品的价格。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "value": 0, "currencyId": "RUR" } ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "parameterValues": [ { "parameterId": 1, "unitId": 0, "valueId": 0, "value": "example" } ], "basicPrice": { "value": 0, "currencyId": "RUR", "discountBase": 0 }, "purchasePrice": { "value": 0, "currencyId": "RUR" }, "additionalExpenses": { "value": 0, "currencyId": "RUR" }, "firstVideoAsCover": true, "deleteParameters": [ "ADDITIONAL_EXPENSES" ] } ``` {% endcut %} {% endcut %} 产品参数。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "offerId": "example", "name": "Ударная дрель Makita HP1630, 710 Вт", "marketCategoryId": 0, "category": "example", "pictures": [ "example" ], "videos": [ "example" ], "manuals": [ { "url": "example", "title": "example" } ], "vendor": "LEVENHUK", "barcodes": [ "46012300000000" ], "description": "example", "manufacturerCountries": [ "Россия" ], "weightDimensions": { "length": 65.55, "width": 50.7, "height": 20, "weight": 1.001 }, "vendorCode": "VNDR-0005A", "tags": [ "до 500 рублей" ], "shelfLife": { "timePeriod": 0, "timeUnit": "HOUR", "comment": "example" }, "lifeTime": { "timePeriod": 0, "timeUnit": "HOUR", "comment": "example" }, "guaranteePeriod": { "timePeriod": 0, "timeUnit": "HOUR", "comment": "example" }, "customsCommodityCode": "8517610008", "commodityCodes": [ { "code": "example", "type": "CUSTOMS_COMMODITY_CODE" } ], "certificates": [ "example" ], "boxCount": 1, "condition": { "type": "PREOWNED", "quality": "PERFECT", "reason": "example" }, "type": "DEFAULT", "downloadable": true, "adult": true, "age": { "value": 0, "ageUnit": "YEAR" }, "params": [ { "name": "Wi-Fi", "value": "есть" } ], "parameterValues": [ { "parameterId": 1, "unitId": 0, "valueId": 0, "value": "example" } ], "basicPrice": { "value": 0, "currencyId": "RUR", "discountBase": 0 }, "purchasePrice": { "value": 0, "currencyId": "RUR" }, "additionalExpenses": { "value": 0, "currencyId": "RUR" }, "firstVideoAsCover": true, "deleteParameters": [ "ADDITIONAL_EXPENSES" ] } ``` {% endcut %} {.table-cell} || || _mapping_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object" %} #| || _marketSku_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: integer 市场上的产品卡的ID。 _Min value:_{.json-schema-reset .json-schema-assertion} `1` {.table-cell} || |#{.json-schema-properties} {% endcut %} 从您的角度来看，市场上适合产品的卡片。 要确定相应卡的ID，请使用机柜中的搜索（**产品中心** → **目录** → **上传产品**). 根据验证结果，市场可以将产品链接到更合适的卡。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "marketSku": 1 } ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% endcut %} 需要添加或更新的产品列表。 {% note warning "Скоро мы уменьшим максимальное количество товаров в запросе" %} 现在不要发送超过100。 {% endnote %}   _Min items:_{.json-schema-reset .json-schema-assertion} `1` _Max items:_{.json-schema-reset .json-schema-assertion} `500` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "offer": { "offerId": "example", "name": "Ударная дрель Makita HP1630, 710 Вт", "marketCategoryId": 0, "category": "example", "pictures": [ "example" ], "videos": [ "example" ], "manuals": [ {} ], "vendor": "LEVENHUK", "barcodes": [ "46012300000000" ], "description": "example", "manufacturerCountries": [ "Россия" ], "weightDimensions": { "length": 65.55, "width": 50.7, "height": 20, "weight": 1.001 }, "vendorCode": "VNDR-0005A", "tags": [ "до 500 рублей" ], "shelfLife": { "timePeriod": 0, "timeUnit": "HOUR", "comment": "example" }, "lifeTime": { "timePeriod": 0, "timeUnit": "HOUR", "comment": "example" }, "guaranteePeriod": { "timePeriod": 0, "timeUnit": "HOUR", "comment": "example" }, "customsCommodityCode": "8517610008", "commodityCodes": [ {} ], "certificates": [ "example" ], "boxCount": 1, "condition": { "type": "PREOWNED", "quality": "PERFECT", "reason": "example" }, "type": "DEFAULT", "downloadable": true, "adult": true, "age": { "value": 0, "ageUnit": "YEAR" }, "params": [ {} ], "parameterValues": [ {} ], "basicPrice": {}, "purchasePrice": { "value": 0, "currencyId": "RUR" }, "additionalExpenses": { "value": 0, "currencyId": "RUR" }, "firstVideoAsCover": true, "deleteParameters": [ "ADDITIONAL_EXPENSES" ] }, "mapping": { "marketSku": 1 } } ] ``` {% endcut %} {.table-cell} || || _onlyPartnerMediaContent_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: boolean 是否只会使用您提供的产品数据。 默认值: `false`. 要删除市场添加的数据，请传递值 `true`. {.table-cell} || |#{.json-schema-properties}
          ## Responses
          ## 200 OK 请求已正确执行，并且数据已被处理。 {% note warning "Ответ `200` сам по себе не значит, что переданные значения корректны" %} 请务必查看响应的详细信息。: `status`，以及错误列表（`results.errors`）和评论（`results.warnings`），如果有的话。 - 如果至少有一个产品返回错误（`results.errors`），场 `status` = `ERROR`. 不会应用对所有转移项目的更改。 - 如果没有错误，但至少有一个产品返回了注释（`results.warnings`），场 `status` = `OK`，并将应用更改。 {% endnote %}
          ### Body {% cut "application/json" %} ```json translate=no { "status": "OK", "results": [ { "offerId": "example", "errors": [ {} ], "warnings": [ {} ] } ] } ``` {% endcut %} **Type**: object {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and} - {% cut "**Type**: object" %} #| || _status_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 响应的类型。 可能的值: * `OK` — 没有错误。 * `ERROR` — 处理请求时出错。 _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR` {.table-cell} || |#{.json-schema-properties} {% endcut %} 服务器响应的标准包装器。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "status": "OK" } ``` {% endcut %} - {% cut "**Type**: object" %} #| || _results_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _offerId_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 你的 SKU — 系统中的产品ID。 使用规则 SKU: * 对于每个产品 SKU 一定有一个。 * 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。 SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 [在市场对卖家的帮助](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku). {% note warning %} 值开头和结尾的空格会自动删除。 例如, `" SKU123 "` 和 `"SKU123"` 它们将被视为相同的值。 {% endnote %} [什么是 SKU 以及如何分配它](https://yandex.ru/support/marketplace/assortment/add/index.html#fields) _Min length:_{.json-schema-reset .json-schema-assertion} `1` _Max length:_{.json-schema-reset .json-schema-assertion} `255` _Pattern:_{.json-schema-reset .json-schema-assertion} `^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$` _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _errors_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _message_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 错误或警告的文本。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _type_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 错误和警告的类型: * `UNKNOWN_CATEGORY` — 指定了未知类别。 * `INVALID_CATEGORY` — 指定了非叶类别。 指定没有子类别的类别。 * `EMPTY_MARKET_CATEGORY` — 在传送类别特征时不指定市场类别。 * `UNKNOWN_PARAMETER` — 已经传输了不属于该类别特征的特征。 * `UNEXPECTED_BOOLEAN_VALUE` — 传递其他内容而不是布尔值。 * `NUMBER_FORMAT` — 传递的字符串不代表数字，而不是数字。 * `INVALID_UNIT_ID` — 特性不可接受的测量单位已经通过。 * `INVALID_GROUP_ID_LENGTH` — 名称中超出允许的字符值 — 255. * `INVALID_GROUP_ID_CHARACTERS` — 转移 [无效字符](*ascii-code). * `INVALID_PICKER_URL` — 已传输到缩略图图像的链接，该链接不包括在传输到产品图像的链接中。 * `LOCKED_DIMENSIONS` — 包装的尺寸已转移，无法更改。 * `INVALID_COMMODITY_CODE` — 传送了不正确的产品代码。 您可以检查哪些类别特征可用于给定类别，并使用请求获取其设置。 [POST v2/category/{categoryId}/parameters](../content/getCategoryContentParameters). _Enum:_{.json-schema-reset .json-schema-value} `UNKNOWN_CATEGORY`, `INVALID_CATEGORY`, `EMPTY_MARKET_CATEGORY`, `UNKNOWN_PARAMETER`, `UNEXPECTED_BOOLEAN_VALUE`, `NUMBER_FORMAT`, `INVALID_UNIT_ID`, `INVALID_GROUP_ID_LENGTH`, `INVALID_GROUP_ID_CHARACTERS`, `INVALID_PICKER_URL`, `LOCKED_DIMENSIONS`, `INVALID_COMMODITY_CODE` {.table-cell} || || _parameterId_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: integer 与错误或警告关联的功能的ID。 {.table-cell} || |#{.json-schema-properties} {% endcut %} 错误。 如果至少有一个产品出现错误，目录中的信息将不会更新所有传输的产品。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "type": "UNKNOWN_CATEGORY", "parameterId": 0, "message": "example" } ] ``` {% endcut %} {.table-cell} || || _warnings_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _message_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 错误或警告的文本。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _type_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 错误和警告的类型: * `UNKNOWN_CATEGORY` — 指定了未知类别。 * `INVALID_CATEGORY` — 指定了非叶类别。 指定没有子类别的类别。 * `EMPTY_MARKET_CATEGORY` — 在传送类别特征时不指定市场类别。 * `UNKNOWN_PARAMETER` — 已经传输了不属于该类别特征的特征。 * `UNEXPECTED_BOOLEAN_VALUE` — 传递其他内容而不是布尔值。 * `NUMBER_FORMAT` — 传递的字符串不代表数字，而不是数字。 * `INVALID_UNIT_ID` — 特性不可接受的测量单位已经通过。 * `INVALID_GROUP_ID_LENGTH` — 名称中超出允许的字符值 — 255. * `INVALID_GROUP_ID_CHARACTERS` — 转移 [无效字符](*ascii-code). * `INVALID_PICKER_URL` — 已传输到缩略图图像的链接，该链接不包括在传输到产品图像的链接中。 * `LOCKED_DIMENSIONS` — 包装的尺寸已转移，无法更改。 * `INVALID_COMMODITY_CODE` — 传送了不正确的产品代码。 您可以检查哪些类别特征可用于给定类别，并使用请求获取其设置。 [POST v2/category/{categoryId}/parameters](../content/getCategoryContentParameters). _Enum:_{.json-schema-reset .json-schema-value} `UNKNOWN_CATEGORY`, `INVALID_CATEGORY`, `EMPTY_MARKET_CATEGORY`, `UNKNOWN_PARAMETER`, `UNEXPECTED_BOOLEAN_VALUE`, `NUMBER_FORMAT`, `INVALID_UNIT_ID`, `INVALID_GROUP_ID_LENGTH`, `INVALID_GROUP_ID_CHARACTERS`, `INVALID_PICKER_URL`, `LOCKED_DIMENSIONS`, `INVALID_COMMODITY_CODE` {.table-cell} || || _parameterId_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: integer 与错误或警告关联的功能的ID。 {.table-cell} || |#{.json-schema-properties} {% endcut %} 警告。 目录中的信息将被更新。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "type": "UNKNOWN_CATEGORY", "parameterId": 0, "message": "example" } ] ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% endcut %} 处理特征列表时出现的错误和警告。 列表中的每个项目对应一个产品。 如果没有错误或警告，则不传递该字段。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "offerId": "example", "errors": [ { "type": "UNKNOWN_CATEGORY", "parameterId": 0, "message": "example" } ], "warnings": [ { "type": "UNKNOWN_CATEGORY", "parameterId": 0, "message": "example" } ] } ] ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% endcut %} {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "results": [ { "offerId": "example", "errors": [ { "type": "UNKNOWN_CATEGORY", "parameterId": 0, "message": "example" } ], "warnings": [ { "type": "UNKNOWN_CATEGORY", "parameterId": 0, "message": "example" } ] } ] } ``` {% endcut %} {% endcut %}
          ## 400 Bad Request ⚠️ 即使问题仅与请求中的一个产品相关，也不会发送到目录。 请求包含不正确的数据。 [详细了解使用产品时出现的错误](../../concepts/error-codes#offers) 和 [关于处理价格时的错误](../../concepts/error-codes#prices)
          ### Body {% cut "application/json" %} ```json translate=no { "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} **Type**: object {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and} - **Type**: object {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and} - **Type**: object #| || _status_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 响应的类型。 可能的值: * `OK` — 没有错误。 * `ERROR` — 处理请求时出错。 _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR` {.table-cell} || |#{.json-schema-properties} 服务器响应的标准包装器。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "status": "OK" } ``` {% endcut %} - **Type**: object #| || _errors_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _code_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 的错误代码。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _message_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 错误的描述。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || |#{.json-schema-properties} {% endcut %} 错误列表。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "code": "example", "message": "example" } ] ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} {% endcut %} 服务器错误的标准包装器。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} {% endcut %}
          ## 401 Unauthorized 请求中未指定授权数据。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#401)
          ### Body {% cut "application/json" %} ```json translate=no { "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} **Type**: object {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and} - **Type**: object {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and} - **Type**: object #| || _status_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 响应的类型。 可能的值: * `OK` — 没有错误。 * `ERROR` — 处理请求时出错。 _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR` {.table-cell} || |#{.json-schema-properties} 服务器响应的标准包装器。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "status": "OK" } ``` {% endcut %} - **Type**: object #| || _errors_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _code_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 的错误代码。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _message_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 错误的描述。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || |#{.json-schema-properties} {% endcut %} 错误列表。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "code": "example", "message": "example" } ] ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} {% endcut %} 服务器错误的标准包装器。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} {% endcut %}
          ## 403 Forbidden 授权数据不正确或禁止访问资源。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#403)
          ### Body {% cut "application/json" %} ```json translate=no { "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} **Type**: object {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and} - **Type**: object {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and} - **Type**: object #| || _status_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 响应的类型。 可能的值: * `OK` — 没有错误。 * `ERROR` — 处理请求时出错。 _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR` {.table-cell} || |#{.json-schema-properties} 服务器响应的标准包装器。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "status": "OK" } ``` {% endcut %} - **Type**: object #| || _errors_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _code_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 的错误代码。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _message_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 错误的描述。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || |#{.json-schema-properties} {% endcut %} 错误列表。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "code": "example", "message": "example" } ] ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} {% endcut %} 服务器错误的标准包装器。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} {% endcut %}
          ## 404 Not Found 未找到请求的资源。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#404)
          ### Body {% cut "application/json" %} ```json translate=no { "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} **Type**: object {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and} - **Type**: object {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and} - **Type**: object #| || _status_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 响应的类型。 可能的值: * `OK` — 没有错误。 * `ERROR` — 处理请求时出错。 _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR` {.table-cell} || |#{.json-schema-properties} 服务器响应的标准包装器。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "status": "OK" } ``` {% endcut %} - **Type**: object #| || _errors_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _code_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 的错误代码。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _message_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 错误的描述。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || |#{.json-schema-properties} {% endcut %} 错误列表。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "code": "example", "message": "example" } ] ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} {% endcut %} 服务器错误的标准包装器。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} {% endcut %}
          ## 420 Method Failure 已超出资源访问限制。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#420)
          ### Body {% cut "application/json" %} ```json translate=no { "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} **Type**: object {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and} - **Type**: object {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and} - **Type**: object #| || _status_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 响应的类型。 可能的值: * `OK` — 没有错误。 * `ERROR` — 处理请求时出错。 _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR` {.table-cell} || |#{.json-schema-properties} 服务器响应的标准包装器。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "status": "OK" } ``` {% endcut %} - **Type**: object #| || _errors_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _code_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 的错误代码。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _message_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 错误的描述。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || |#{.json-schema-properties} {% endcut %} 错误列表。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "code": "example", "message": "example" } ] ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} {% endcut %} 服务器错误的标准包装器。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} {% endcut %}
          ## 423 Locked 指定的方法不能应用于资源。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#423)
          ### Body {% cut "application/json" %} ```json translate=no { "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} **Type**: object {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and} - **Type**: object {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and} - **Type**: object #| || _status_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 响应的类型。 可能的值: * `OK` — 没有错误。 * `ERROR` — 处理请求时出错。 _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR` {.table-cell} || |#{.json-schema-properties} 服务器响应的标准包装器。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "status": "OK" } ``` {% endcut %} - **Type**: object #| || _errors_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _code_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 的错误代码。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _message_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 错误的描述。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || |#{.json-schema-properties} {% endcut %} 错误列表。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "code": "example", "message": "example" } ] ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} {% endcut %} 服务器错误的标准包装器。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} {% endcut %}
          ## 500 Internal Server Error Yandex的内部错误。 市场。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#500)
          ### Body {% cut "application/json" %} ```json translate=no { "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} **Type**: object {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and} - **Type**: object {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and} - **Type**: object #| || _status_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 响应的类型。 可能的值: * `OK` — 没有错误。 * `ERROR` — 处理请求时出错。 _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR` {.table-cell} || |#{.json-schema-properties} 服务器响应的标准包装器。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "status": "OK" } ``` {% endcut %} - **Type**: object #| || _errors_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _code_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 的错误代码。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _message_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 错误的描述。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || |#{.json-schema-properties} {% endcut %} 错误列表。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "code": "example", "message": "example" } ] ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} {% endcut %} 服务器错误的标准包装器。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } ``` {% endcut %} {% endcut %}
          - Console ```openapi-sandbox translate=no pathParams: - description: "内阁ID。\n\n\n:::no-translate\n{% if audience == \"partner\" %}\n:::\n\n\n要找到答案，请使用请求 [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [什么是市场上的橱柜和商店？](https://yandex.ru/support/marketplace/account/introduction.html)\n\n\n:::no-translate\n{% endif %}\n:::\n\n" name: businessId in: path required: true schema: type: integer format: int64 minimum: 1 searchParams: - description: | 接受和返回参数中的值的语言 `name` 和 `description`. 默认值: `RU`. name: language in: query required: false schema: description: | 语言: * `RU` — 俄语。 * `UZ` — 乌兹别克。 type: string enum: - RU - UZ headers: [] body: |- { "offerMappings": [ { "offer": { "offerId": "example", "name": "Ударная дрель Makita HP1630, 710 Вт", "marketCategoryId": 0, "category": "example", "pictures": [ null ], "videos": [ null ], "manuals": [ null ], "vendor": "LEVENHUK", "barcodes": [ null ], "description": "example", "manufacturerCountries": [ null ], "weightDimensions": {}, "vendorCode": "VNDR-0005A", "tags": [ null ], "shelfLife": {}, "lifeTime": {}, "guaranteePeriod": {}, "customsCommodityCode": "8517610008", "commodityCodes": [ null ], "certificates": [ null ], "boxCount": 1, "condition": {}, "type": "DEFAULT", "downloadable": true, "adult": true, "age": {}, "params": [ null ], "parameterValues": [ null ], "basicPrice": {}, "purchasePrice": {}, "additionalExpenses": {}, "firstVideoAsCover": true, "deleteParameters": [ null ] }, "mapping": { "marketSku": 1 } } ], "onlyPartnerMediaContent": true } schema: type: object required: - offerMappings properties: offerMappings: description: "需要添加或更新的产品列表。\n\n\n:::no-translate\n{% note warning \"Скоро мы уменьшим максимальное количество товаров в запросе\" %}\n:::\n\n\n现在不要发送超过100。\n\n\n:::no-translate\n{% endnote %}\n:::\n\n\n\_\n" type: array minItems: 1 maxItems: 500 items: description: 产品信息。 type: object required: - offer properties: offer: description: 产品参数。 type: object allOf: - description: 产品的主要参数。 type: object required: - offerId properties: offerId: description: "你的 SKU —\_系统中的产品ID。\n\n使用规则 SKU:\n\n* 对于每个产品 SKU 一定有一个。\n\n* 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。\n\nSKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 [在市场对卖家的帮助](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).\n\n\n:::no-translate\n{% note warning %}\n:::\n\n\n值开头和结尾的空格会自动删除。 例如, `\" SKU123 \"` 和 `\"SKU123\"` 它们将被视为相同的值。\n\n\n:::no-translate\n{% endnote %}\n:::\n\n\n[什么是 SKU 以及如何分配它](https://yandex.ru/support/marketplace/assortment/add/index.html#fields)\n" type: string pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$ x-transform: trim minLength: 1 maxLength: 255 internalOfferId: description: 市场系统中产品的内部标识符。 它需要创建具有不同offerids的商店和食品。 type: string minLength: 1 maxLength: 255 x-hidden: true name: description: > 根据方案组成名称：类型+品牌或制造商+型号+功能，如果有的话（例如，颜色，尺寸或重量）和数量在包装中。 不包括情感特征（"命中"，"超级"等。）以销售条款的名义（例如，"折扣"，"免费送货"等。). 不要用大写字母写单词。 — 除了成熟的品牌名称和型号。 最佳长度 — 50-60个字符。 [建议和规则](https://yandex.ru/support/marketplace/assortment/fields/title.html) example: Ударная дрель Makita HP1630, 710 Вт type: string maxLength: 256 marketCategoryId: description: "您将产品归因于市场上类别的ID。\n\n\n:::no-translate\n{% note warning \"Всегда указывайте, когда передаете `parameterValues`\" %}\n:::\n\n\n如果，在改变特征时，通过 `parameterValues` 并且不指定 `marketCategoryId`，特征将被更新，但您将在响应中收到警告（参数 `warnings`).\n\n如果您不传递这两个参数，则将使用来自过时参数的信息。 `params` 和 `category`，而 `marketCategoryId` 它将被自动检测到。\n\n\n:::no-translate\n{% endnote %}\n:::\n\n\n更改类别时，请确保参数中的产品特性及其值 `parameterValues` 您正在提交一个新的类别.\n\n您可以使用请求获取市场类别列表。 [POST\_v2/categories/tree](../../reference/categories/getCategoriesTree.md).\n" type: integer format: int64 minimum: 0 exclusiveMinimum: true category: description: "\n:::no-translate\n{% note warning \"Вместо него используйте `marketCategoryId`.\" %}\n:::\n\n\n\_\n\n\n:::no-translate\n{% endnote %}\n:::\n\n\n您商店中的产品类别。\n" type: string deprecated: true pictures: description: > 产品图片的链接。 第一个链接上的图像被认为是主要的，其他的是额外的。 **连结要求** * 指定整个链接，包括http或https协议。 * 俄文字母 URL 阿美。 * 您可以使用直接链接到图像和Yandex的。磁盘。 Yandex上的链接。必须使用函数**共享**复制磁盘。 与其他云存储的相对链接和链接 — 它们不起作用。 ✅ `https://example-shop.ru/images/sku12345.jpg` ✅ `https://yadi.sk/i/NaBoRsimVOLov` ❌ `/images/sku12345.jpg` ❌ `https://www.dropbox.com/s/818f/tovar.jpg` 与图像的链接必须是永久性的。 不能使用从上载更改为上载的动态链接。 如果您需要替换图像，请通过新链接上传新图像，并删除到旧图像的链接。 如果您只是从旧链接替换图像，它将不会更新。 [图像要求](https://yandex.ru/support/marketplace/assortment/fields/images.html) type: array nullable: true minItems: 1 maxItems: 30 uniqueItems: false items: type: string minLength: 1 maxLength: 2000 videos: description: > 连结(URL）上的产品视频。 **连结要求** * 指定整个链接，包括http或https协议。 * 俄文字母 URL 阿美。 * 您可以使用视频和Yandex的直接链接。磁盘。 Yandex上的链接。必须使用函数**共享**复制磁盘。 与其他云存储的相对链接和链接 — 它们不起作用。 ✅ `https://example-shop.ru/video/sku12345.avi` ✅ `https://yadi.sk/i/NaBoRsimVOLov` ❌ `/video/sku12345.avi` ❌ `https://www.dropbox.com/s/818f/super-tovar.avi` 视频链接必须是永久性的。 不能使用从上载更改为上载的动态链接。 如果您需要更换视频，请通过新链接上传新视频，并删除旧视频的链接。 如果您只是使用旧链接替换视频，它将不会更新。 [视频要求](https://yandex.ru/support/marketplace/assortment/fields/video.html) type: array nullable: true minItems: 1 maxItems: 6 uniqueItems: false items: type: string minLength: 1 maxLength: 2000 manuals: description: | 有关如何使用产品的说明列表。 type: array nullable: true minItems: 1 maxItems: 6 items: type: object required: - url description: | 产品使用说明。 properties: url: type: string minLength: 1 maxLength: 2000 title: description: | 将显示在产品卡上的指令的名称。 type: string maxLength: 500 vendor: description: 品牌或制造商的名称。 它应该按照品牌本身的方式编写。 example: LEVENHUK type: string barcodes: description: > 条形码。 将其指定为数字序列。 密码可以 EAN-13, EAN-8, UPC-A, UPC-E 或 Code 128. 对于书籍 — ISBN. 对于产品 [某些类别和品牌](https://yastatic.net/s3/doc-binary/src/support/market/ru/yandex-market-list-for-gtin.xlsx) 条形码必须是有效的代码。 GTIN. 请注意：内部条码以2或02开头，以及格式代码 Code 128 他们不是 GTIN. 【是什么 GTIN](*gtin) type: array nullable: true minItems: 1 uniqueItems: true items: type: string example: '46012300000000' description: description: > 详细的产品说明：例如，它的优点和特点。 说明中不提供安装和装配说明。 不要使用"折扣"，"销售"，"便宜"，"礼品"（礼品类别除外），"免费"，"特价"，"特价"，"新奇"，"新"，"模拟"，"订单"，"点击"等字样。 不要提供任何联系信息或链接。 HTML标签可用于格式化文本: * \，\

          ，\

          等等 — 新闻标题; * \
          和\

          — 对于换行符; * \

            — 对于编号列表; * \
              — 对于项目符号列表。 * \<李> — 创建列表项（必须在\
                或\
                  内）; * \
                  — 支持，但不影响文本显示。 最佳长度 — 400-600个字符。 [建议和规则](https://yandex.ru/support/marketplace/assortment/fields/description.html) type: string maxLength: 6000 manufacturerCountries: description: > 产品生产的国家。 写下这些国家的名字，因为它们是写在 [名单](https://yastatic.net/s3/doc-binary/src/support/market/ru/countries.xlsx). type: array nullable: true minItems: 1 uniqueItems: true items: type: string example: Россия weightDimensions: description: > 包装的尺寸和产品的重量。 如果产品占用几个盒子，在测量尺寸之前将它们紧凑地折叠起来。 ![多座位货物测量方案](../../_images/reference/boxes-measure.png) type: object required: - length - width - height - weight properties: length: description: | 包装长度以厘米为单位。 example: 65.55 type: number minimum: 0 width: description: | 包装宽度以厘米为单位。 example: 50.7 type: number minimum: 0 height: description: | 包装高度以厘米为单位。 example: 20 type: number minimum: 0 weight: description: | 以公斤为单位的产品重量，包括包装（毛）。 example: 1.001 type: number minimum: 0 vendorCode: description: 从制造商的产品的文章。 example: VNDR-0005A type: string tags: description: > 商店使用的产品标签。 标签对客户不可见。 您可以按标签对目录中的不同产品进行分组和筛选。 — 例如，同一系列、系列或系列的产品。 最大标签长度 — 20个字符。 一个产品最多可以有10个标签. type: array nullable: true minItems: 1 maxItems: 50 uniqueItems: true items: type: string example: до 500 рублей shelfLife: description: 带有注释的时间段。 注释内容的要求取决于参数用法的上下文，并在包含它的字段的描述中指定。 type: object required: - timePeriod - timeUnit properties: timePeriod: description: 指定单位的持续时间。 type: integer timeUnit: description: | 时间测量单元: * `HOUR` — 小时。 * `DAY` — 一天。 * `WEEK` — 一个星期。 * `MONTH` — 月份。 * `YEAR` — 年。 type: string enum: - HOUR - DAY - WEEK - MONTH - YEAR comment: description: 评论。 type: string maxLength: 500 lifeTime: description: 带有注释的时间段。 注释内容的要求取决于参数用法的上下文，并在包含它的字段的描述中指定。 type: object required: - timePeriod - timeUnit properties: timePeriod: description: 指定单位的持续时间。 type: integer timeUnit: description: | 时间测量单元: * `HOUR` — 小时。 * `DAY` — 一天。 * `WEEK` — 一个星期。 * `MONTH` — 月份。 * `YEAR` — 年。 type: string enum: - HOUR - DAY - WEEK - MONTH - YEAR comment: description: 评论。 type: string maxLength: 500 guaranteePeriod: description: 带有注释的时间段。 注释内容的要求取决于参数用法的上下文，并在包含它的字段的描述中指定。 type: object required: - timePeriod - timeUnit properties: timePeriod: description: 指定单位的持续时间。 type: integer timeUnit: description: | 时间测量单元: * `HOUR` — 小时。 * `DAY` — 一天。 * `WEEK` — 一个星期。 * `MONTH` — 月份。 * `YEAR` — 年。 type: string enum: - HOUR - DAY - WEEK - MONTH - YEAR comment: description: 评论。 type: string maxLength: 500 customsCommodityCode: description: "\n:::no-translate\n{% note warning \"Вместо него используйте `commodityCodes` с типом `CUSTOMS_COMMODITY_CODE`.\" %}\n:::\n\n\n\_\n\n\n:::no-translate\n{% endnote %}\n:::\n\n\n对外经济活动统一商品命名法（HS）中的产品代码 — 没有空格的10或14位数字。\n\n一定要指出是否有。\n" deprecated: true example: '8517610008' type: string commodityCodes: description: | 产品代码。 type: array nullable: true minItems: 1 items: description: 产品代码。 type: object required: - code - type properties: code: description: 产品代码。 type: string type: description: > 产品代码类型: * `CUSTOMS_COMMODITY_CODE` — 对外经济活动统一商品命名法（HS）中的产品代码 — 没有空格的10或14位数字。 * `IKPU_CODE` — 乌兹别克斯坦产品和服务的识别码为17位数字，无空格。 不要发送相同类型的多个代码。 type: string enum: - CUSTOMS_COMMODITY_CODE - IKPU_CODE certificates: description: > 产品文件的编号:证书、符合性声明等. 你只可透过以下途径传送文件编号，而文件编号的扫描件已上载于商户的办公室 [指示说明](https://yandex.ru/support/marketplace/assortment/restrictions/certificates.html). type: array nullable: true minItems: 1 maxItems: 6 uniqueItems: true items: type: string boxCount: description: > 货位的数量。 如果产品由多个盒子、包装等组成，则使用此参数。 例如，空调占用两个座位 — 外部和内部单元在两个盒子里。 对于占据一个位置的产品，不要传递此参数。 type: integer format: int32 minimum: 1 condition: description: | 折扣产品的状况。 type: object properties: type: description: > 标记类型: * `PREOWNED` — 曾经属于另一个人的二手货。 * `SHOWCASESAMPLE` — 展示样品。 * `REFURBISHED` — 产品的再销售。 * `REDUCTION` — 产品有缺陷。 * `RENOVATED` — 的还原产物。 * `NOT_SPECIFIED` — 未被选中。 `REFURBISHED` — 衣服，鞋子和配饰的特殊价值。 它仅用于此类别的折扣产品。 不使用服装、鞋和配件的其他值。 type: string enum: - PREOWNED - SHOWCASESAMPLE - REFURBISHED - REDUCTION - RENOVATED - NOT_SPECIFIED quality: description: > 产品外观: * `PERFECT` — 理想。 * `EXCELLENT` — 善乎哉！. * `GOOD` — 好。 * `NOT_SPECIFIED` — 未被选中。 type: string enum: - PERFECT - EXCELLENT - GOOD - NOT_SPECIFIED reason: description: | 产品说明。 详细描述缺陷，它们的明显程度以及在哪里寻找它们。 type: string type: description: "特殊类型的产品:\n\n* `DEFAULT` — 产品，你以前提供了一个特殊的类型，并希望将其删除。\n* `MEDICINE` — 药品。\n* `BOOK` — 纸质和电子书。\n* `AUDIOBOOK` — 有声读物。\n* `ARTIST_TITLE` — 音乐和视频制作。\n* `ON_DEMAND` — 定制产品。\n* `ALCOHOL` — 酒精。\n\n\n:::no-translate\n{% note info \"Если ваш товар —\_книга\" %}\n:::\n\n\n在产品规格中指定发布年份。 [有关参数的更多信息](../../reference/business-offer-mappings/updateOfferMappings.md#offerparamdto)\n\n\n:::no-translate\n{% endnote %}\n:::\n\n" type: string enum: - DEFAULT - MEDICINE - BOOK - AUDIOBOOK - ARTIST_TITLE - ON_DEMAND - ALCOHOL downloadable: description: | 数字产品的标志。 指定 `true` 如果产品是通过电子邮件交付的。 [如何使用数字商品](../../step-by-step/digital.md) type: boolean adult: description: | 该参数包括产品的标签18+。 仅将其设置为与满足性需求相关的产品。 type: boolean age: description: 年龄在指定的测量单位。 type: object required: - value - ageUnit properties: value: description: | 意义。 type: number minimum: 0 ageUnit: description: | 年龄测量单位: * `YEAR` — 年。 * `MONTH` — 月份。 type: string enum: - YEAR - MONTH params: description: "\n:::no-translate\n{% note warning \"При передаче характеристик используйте `parameterValues`.\" %}\n:::\n\n\n\_\n\n\n:::no-translate\n{% endnote %}\n:::\n\n\n只有特定类别的产品才具有的特性。 — 例如，自行车车轮的直径或鞋底的材料。\n" type: array nullable: true minItems: 1 deprecated: true items: description: >+ 产品参数。 如果产品具有相同参数的多个值，则使用相同的值发送它们 `name`，但不同 `value`. {% cut "Пример" %} ```json translate=no "params": [ { "name": "Цвет для фильтра", "value": "Зеленый" }, { "name": "Цвет для фильтра", "value": "Желтый" } ] ``` {% endcut %} type: object required: - name - value properties: name: description: "特性的名称。\n\n它必须与市场上的功能名称相匹配。 您可以从类别的Excel模板或通过查询找到它。 [POST\_v2/category/{categoryId}/parameters](../content/getCategoryContentParameters.md).\n" example: Wi-Fi type: string maxLength: 200 value: description: | 意义。 example: есть type: string - properties: parameterValues: description: > 具有其值的特征列表。 {% note warning "Всегда передавайте вместе с `marketCategoryId`" %} 如果你不通过它 `marketCategoryId` 当特征发生变化时，它们将被更新，但在响应中会收到警告（参数 `warnings`). 如果您不传递这两个参数，则将使用来自过时参数的信息。 `params` 和 `category`，而 `marketCategoryId` 它将被自动检测到。 {% endnote %} 当**改变**特性时，仅传送其值需要更新的那些。 如果在 `marketCategoryId` 您正在更改类别，新旧类别的共同特征的值将保留，并且您不需要转移它们。 阅读更多 ["特性值的传递"](../../step-by-step/parameter-values.md). type: array nullable: true minItems: 1 maxItems: 300 items: description: | 特性的值。 type: object required: - parameterId properties: parameterId: description: 特性的标识符。 type: integer format: int64 minimum: 1 unitId: description: 测量单位的ID。 如果没有传递参数 `unitId`，使用默认的测量单位。 type: integer format: int64 valueId: description: | 值的ID。 - 如果要从从市场接收的可接受值列表中传输值，请务必指定标识符。 - 不要为自己的值指定。 - 仅针对类型特征 `ENUM`. type: integer format: int64 value: description: | 意义。 对于类型特征 `ENUM` 发送: - 与 `valueId`，如果从目录取值; - 没有 `valueId`，如果值是它自己的。 type: string basicPrice: description: 价格与折扣指示. type: object allOf: - description: 品的价格。 type: object required: - value - currencyId properties: value: description: 品的价格。 type: number minimum: 0 exclusiveMinimum: true currencyId: type: string description: | 货币代码: * `RUR` — 俄罗斯卢布。 * `UAH` — 乌克兰格里夫纳。 * `BYR` — 白俄罗斯卢布。 * `KZT` — 哈萨克斯坦坚戈。 * `UZS` — 乌兹别克总和。 enum: - RUR - USD - EUR - UAH - AUD - GBP - BYR - BYN - DKK - ISK - KZT - CAD - CNY - NOK - XDR - SGD - TRY - SEK - CHF - JPY - AZN - ALL - DZD - AOA - ARS - AMD - AFN - BHD - BGN - BOB - BWP - BND - BRL - BIF - HUF - VEF - KPW - VND - GMD - GHS - GNF - HKD - GEL - AED - EGP - ZMK - ILS - INR - IDR - JOD - IQD - IRR - YER - QAR - KES - KGS - COP - CDF - CRC - KWD - CUP - LAK - LVL - SLL - LBP - LYD - SZL - LTL - MUR - MRO - MKD - MWK - MGA - MYR - MAD - MXN - MZN - MDL - MNT - NPR - NGN - NIO - NZD - OMR - PKR - PYG - PEN - PLN - KHR - SAR - RON - SCR - SYP - SKK - SOS - SDG - SRD - TJS - THB - TWD - BDT - TZS - TND - TMM - UGX - UZS - UYU - PHP - DJF - XAF - XOF - HRK - CZK - CLP - LKR - EEK - ETB - RSD - ZAR - KRW - NAD - TL - UE - properties: discountBase: description: | 划掉的价格。 数字必须是整数。 您可以指定折扣从5到99％的价格。 如果您提供产品折扣，则在每次更新价格时传递此参数。 type: number minimum: 0 exclusiveMinimum: true purchasePrice: description: 品的价格。 type: object required: - value - currencyId properties: value: description: 品的价格。 type: number minimum: 0 exclusiveMinimum: true currencyId: type: string description: | 货币代码: * `RUR` — 俄罗斯卢布。 * `UAH` — 乌克兰格里夫纳。 * `BYR` — 白俄罗斯卢布。 * `KZT` — 哈萨克斯坦坚戈。 * `UZS` — 乌兹别克总和。 enum: - RUR - USD - EUR - UAH - AUD - GBP - BYR - BYN - DKK - ISK - KZT - CAD - CNY - NOK - XDR - SGD - TRY - SEK - CHF - JPY - AZN - ALL - DZD - AOA - ARS - AMD - AFN - BHD - BGN - BOB - BWP - BND - BRL - BIF - HUF - VEF - KPW - VND - GMD - GHS - GNF - HKD - GEL - AED - EGP - ZMK - ILS - INR - IDR - JOD - IQD - IRR - YER - QAR - KES - KGS - COP - CDF - CRC - KWD - CUP - LAK - LVL - SLL - LBP - LYD - SZL - LTL - MUR - MRO - MKD - MWK - MGA - MYR - MAD - MXN - MZN - MDL - MNT - NPR - NGN - NIO - NZD - OMR - PKR - PYG - PEN - PLN - KHR - SAR - RON - SCR - SYP - SKK - SOS - SDG - SRD - TJS - THB - TWD - BDT - TZS - TND - TMM - UGX - UZS - UYU - PHP - DJF - XAF - XOF - HRK - CZK - CLP - LKR - EEK - ETB - RSD - ZAR - KRW - NAD - TL - UE additionalExpenses: description: 品的价格。 type: object required: - value - currencyId properties: value: description: 品的价格。 type: number minimum: 0 exclusiveMinimum: true currencyId: type: string description: | 货币代码: * `RUR` — 俄罗斯卢布。 * `UAH` — 乌克兰格里夫纳。 * `BYR` — 白俄罗斯卢布。 * `KZT` — 哈萨克斯坦坚戈。 * `UZS` — 乌兹别克总和。 enum: - RUR - USD - EUR - UAH - AUD - GBP - BYR - BYN - DKK - ISK - KZT - CAD - CNY - NOK - XDR - SGD - TRY - SEK - CHF - JPY - AZN - ALL - DZD - AOA - ARS - AMD - AFN - BHD - BGN - BOB - BWP - BND - BRL - BIF - HUF - VEF - KPW - VND - GMD - GHS - GNF - HKD - GEL - AED - EGP - ZMK - ILS - INR - IDR - JOD - IQD - IRR - YER - QAR - KES - KGS - COP - CDF - CRC - KWD - CUP - LAK - LVL - SLL - LBP - LYD - SZL - LTL - MUR - MRO - MKD - MWK - MGA - MYR - MAD - MXN - MZN - MDL - MNT - NPR - NGN - NIO - NZD - OMR - PKR - PYG - PEN - PLN - KHR - SAR - RON - SCR - SYP - SKK - SOS - SDG - SRD - TJS - THB - TWD - BDT - TZS - TND - TMM - UGX - UZS - UYU - PHP - DJF - XAF - XOF - HRK - CZK - CLP - LKR - EEK - ETB - RSD - ZAR - KRW - NAD - TL - UE firstVideoAsCover: deprecated: true description: > 使用卡中的第一个视频作为视频背景。 传下去 `true` 为第一视频作为视频背景，或 `false` 使视频背景不显示在产品配置文件中。 type: boolean deleteParameters: description: "您之前传递给的参数 `UpdateOfferDTO`，现在你想删除它。\n\n如果您发送 `adult`, `downloadable` 和 `firstVideoAsCover` 它们不会被删除 —\_它们的值将变为 `false`.\n\n您可以一次传递多个值。\n\n不要与相应的参数一起使用 `UpdateOfferDTO`. 这将导致错误。 `400`.\n" type: array nullable: true minItems: 1 uniqueItems: true items: description: > 要删除的参数的值和相应的参数 `UpdateOfferDTO` 您之前传递这些值的方式: * `ADDITIONAL_EXPENSES` — 产品的额外费用（参数 `additionalExpenses`). * `ADULT` — 标记18+(参数 `adult`) * `AGE` — 儿童年龄限制（参数 `age`). * `BARCODES` — 条码(参数 `barcodes`). * `BOX_COUNT` — 货位数（参数 `boxCount`). * `CERTIFICATES` — 产品文档编号（参数 `certificates`). * `COMMODITY_CODES` — 产品代码（参数 `commodityCodes`). * `CONDITION` — 折扣产品的条件（参数 `condition`). * `CUSTOMS_COMMODITY_CODE` — HS代码中的产品代码（参数 `customsCommodityCode`). * `DESCRIPTION` — 产品说明（参数 `description`). * `DOWNLOADABLE` — 数字产品属性（参数 `downloadable`). * `GUARANTEE_PERIOD` — 保修期（参数 `guaranteePeriod`). * `LIFE_TIME` — 使用寿命（参数 `lifeTime`). * `MANUALS` — 产品使用说明列表（参数 `manuals`). * `MANUFACTURER_COUNTRIES` — 生产国（参数） `manufacturerCountries`). * `PARAMETERS` — 产品特性（参数 `params`, `parameterValues`). * `PICTURES` — 产品图片链接（参数 `pictures`). * `PURCHASE_PRICE` — 成本价（参数 `purchasePrice`). * `SHELF_LIFE` — 到期日期（参数 `shelfLife`). * `TAGS` — 商店使用的产品标签（参数 `tags`). * `TYPE` — 一种特殊类型的产品（参数 `type`). * `VENDOR_CODE` — 品牌或制造商的名称（参数 `vendorCode`). * `VIDEOS` — 产品视频链接（参数 `videos`). type: string enum: - ADDITIONAL_EXPENSES - ADULT - AGE - BARCODES - BOX_COUNT - CERTIFICATES - COMMODITY_CODES - CONDITION - CUSTOMS_COMMODITY_CODE - DESCRIPTION - DOWNLOADABLE - GUARANTEE_PERIOD - LIFE_TIME - MANUALS - MANUFACTURER_COUNTRIES - PARAMETERS - PICTURES - PURCHASE_PRICE - SHELF_LIFE - TAGS - TYPE - VENDOR_CODE - VIDEOS mapping: description: > 从您的角度来看，市场上适合产品的卡片。 要确定相应卡的ID，请使用机柜中的搜索（**产品中心** → **目录** → **上传产品**). 根据验证结果，市场可以将产品链接到更合适的卡。 type: object properties: marketSku: description: 市场上的产品卡的ID。 type: integer format: int64 minimum: 1 onlyPartnerMediaContent: description: | 是否只会使用您提供的产品数据。 默认值: `false`. 要删除市场添加的数据，请传递值 `true`. type: boolean bodyType: application/json method: post security: - type: apiKey name: 'Api-Key' in: header - type: oauth2 x-inline: true flows: implicit: authorizationUrl: https://oauth.yandex.ru/authorize scopes: market:partner-api: API Яндекс.Маркета / Поиска по товарам для партнеров path: v2/businesses/{businessId}/offer-mappings/update host: https://api.partner.market.yandex.ru ``` {% endlist %}
                  [*Deprecated]: No longer supported, please use an alternative and newer version. [*gtin]: 什么是GTIN？
                  [医]GTIN — 这是在单个国际数据库中分配给产品的唯一编号。 [GS1](https://ru.wikipedia.org/wiki/GS1). 此编号生成EAN、UPC或ISBN条形码。

                  如何确保产品在数据库中
                  你可以在 [验证页面](https://gepir.gs1.org/index.php/search-by-gtin) 在GS1协会的网站上。 如果未找到产品，请向供应商索取GTIN代码。

                  如何为您的产品获取GTIN
                  要接收GTIN代码，制造商需要加入GS1协会并注册产品。 [*ascii-code]: ASCII字符0到31（9除外）和127被禁止。 [从表](https://www.ascii-code.com/compact). [*list-categories]: 没有孩子的类别。