--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://yandex.com/dev/market/partner-api/doc/en/reference/business-offer-mappings/getOfferMappings.md - https://yandex.com/dev/market/partner-api/doc/ru/reference/business-offer-mappings/getOfferMappings.md - https://yandex.com/dev/market/partner-api/doc/zh/reference/business-offer-mappings/getOfferMappings.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) * offers-and-cards-management:read-only — [查看商品和卡片](https://yandex.com/dev/market/partner-api/doc/zh/_auto/scopes_summary/pages/offers-and-cards-management_read-only.md) * all-methods — 全面管理账户 * all-methods:read-only — 查看所有数据 {% endcut %} 返回目录中的产品列表，它们在市场上的类别以及每个产品的特性。 它可以用在三种方式: * 设置感兴趣的人的列表 SKU; * 设置过滤器 — 在这种情况下，结果将逐页返回; * 不要发送请求正文以获取目录中所有产品的列表。 要获得产品的类别特征，请使用以下方法 [POST v2/businesses/{businessId}/offer-cards](https://yandex.com/dev/market/partner-api/doc/zh/reference/content/getOfferCardsContentStatus.md). |
**⚙️ 没有订阅的限制:** 100 请求 每分钟
**⭐️ [使用中等订阅限制](https://yandex.ru/support/marketplace/ru/marketing/subscription):** 600 请求 每分钟
| |-| ## Request
POST {.openapi__method} ```text translate=no https://api.partner.market.yandex.ru/v2/businesses/{businessId}/offer-mappings ```
### 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} || || _limit_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: integer 每页的值数。

如果参数值超过允许的最大值，它将减少到最大值。 _Default:_{.json-schema-reset .json-schema-value} `50` _Min value:_{.json-schema-reset .json-schema-assertion} `1` _Max value:_{.json-schema-reset .json-schema-assertion} `100` {.table-cell} || || _pageToken_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 结果页面的ID。 如果省略该参数，则返回第一页。 传递输出参数的值 `nextPageToken`，在最后一次请求期间接收。 _Example:_{.json-schema-reset .json-schema-example} `` {.table-cell} || |#{.json-schema-properties}
### Body {% cut "application/json" %} ```json translate=no { "offerIds": [ "example" ], "cardStatuses": [ "HAS_CARD_CAN_NOT_UPDATE" ], "categoryIds": [ 0 ], "vendorNames": [ "example" ], "tags": [ "example" ], "archived": true } ``` {% endcut %} #| || **Name** | **Description** || || _archived_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: boolean 按存档中的位置过滤。 传下去 `true` 以接收存档中的项目。 如果过滤器未填充或通过 `false`，响应返回不在存档中的项。 {.table-cell} || || _cardStatuses_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string[] | null 按卡状态过滤。 [什么是产品卡？](https://yandex.ru/support/marketplace/assortment/content/index.html) _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 [ "HAS_CARD_CAN_NOT_UPDATE" ] ``` {% endcut %} {.table-cell} || || _categoryIds_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: integer[] | null 在市场上按类别过滤。 _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 [ 0 ] ``` {% endcut %} {.table-cell} || || _offerIds_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string[] | null 需要信息的产品的Id。 {% note warning "Такой список возвращается только целиком" %} 如果你要求提供特定的资料 SKU，不填写: * `pageToken`; * `limit`; * `cardStatuses`; * `categoryIds`; * `vendorNames`; * `tags`; * `archived`. {% endnote %}   _Min items:_{.json-schema-reset .json-schema-assertion} `1` _Max items:_{.json-schema-reset .json-schema-assertion} `100` _Unique items:_{.json-schema-reset .json-schema-assertion} `true` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ "example" ] ``` {% endcut %} {.table-cell} || || _tags_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string[] | null 按标签过滤。 _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 [ "example" ] ``` {% endcut %} {.table-cell} || || _vendorNames_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string[] | null 按品牌过滤。 _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 [ "example" ] ``` {% endcut %} {.table-cell} || |#{.json-schema-properties}
## Responses
## 200 OK 目录中有关产品的信息。
### Body {% cut "application/json" %} ```json translate=no { "status": "OK", "result": { "paging": { "nextPageToken": "example" }, "offerMappings": [ { "offer": {}, "mapping": {}, "showcaseUrls": [ null ] } ] } } ``` {% 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" %} #| || _result_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object" %} #| || _offerMappings_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| {% cut "**Type**: object[]" %} #| || _mapping_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: object {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and} - **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} 从您的角度来看，市场上适合产品的卡片。 要确定相应卡的ID，请使用机柜中的搜索（**产品中心** → **目录** → **上传产品**). 根据验证结果，市场可以将产品链接到更合适的卡。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "marketSku": 1 } ``` {% endcut %} - **Type**: object #| || _marketCategoryId_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: integer 品所属的市场上的类别的ID。 如果市场尚未确定产品类别，则可能会在响应中缺失。 {.table-cell} || || _marketCategoryName_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 卡的类别在市场上的名称。 如果市场尚未确定产品类别，则可能会在响应中缺失。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _marketModelName_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact} {.table-cell}| **Type**: string 市场上型号的名称。 如果产品尚未链接到卡，则可能不会包含在响应中。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _marketSkuName_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 产品卡的名称。 如果产品尚未链接到卡，则可能不会包含在响应中。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || |#{.json-schema-properties} {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "marketSkuName": "example", "marketModelName": "example", "marketCategoryId": 0, "marketCategoryName": "example" } ``` {% endcut %} {% endcut %} 目录中有关产品的信息。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "marketSku": 1, "marketSkuName": "example", "marketModelName": "example", "marketCategoryId": 0, "marketCategoryName": "example" } ``` {% endcut %} {.table-cell} || || _offer_{.json-schema-reset .json-schema-property} {.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` _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) _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` {% 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) _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 产品图片的链接。 第一个链接上的图像被认为是主要的，其他的是额外的。 **连结要求** * 最多可以有30个链接。 * 指定整个链接，包括http或https协议。 * 最大长度 — 512个字符。 * 俄文字母 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` {% 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协议。 * 最大长度 — 512个字符。 * 俄文字母 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` {% 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}| **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 #| || _updatedAt_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string<date-time> 上次更新的时间。 _Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z` {.table-cell} || |#{.json-schema-properties} 上次更新的时间。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "updatedAt": "2025-01-01T00:00:00Z" } ``` {% endcut %} {% endcut %} 指示上次更新时间的价格。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "value": 0, "currencyId": "RUR", "updatedAt": "2025-01-01T00:00:00Z" } ``` {% endcut %} {.table-cell} || || _archived_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: boolean 产品已存档。 {.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 {% 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 %} - **Type**: object #| || _updatedAt_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string<date-time> 上次更新的时间。 _Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z` {.table-cell} || |#{.json-schema-properties} 上次更新的时间。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "updatedAt": "2025-01-01T00:00:00Z" } ``` {% endcut %} {% endcut %} 价格包括货币、折扣和上次更新的时间. {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "value": 0, "currencyId": "RUR", "discountBase": 0, "updatedAt": "2025-01-01T00:00:00Z" } ``` {% endcut %} {.table-cell} || || _campaigns_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _campaignId_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: integer 广告系列（商店）的ID — 通过API工作时，代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接，但仅用于自动交互。 您可以使用查询找到它 [GET v2/campaigns](https://yandex.com/dev/market/partner-api/doc/zh/reference/campaigns/getCampaigns.md) 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ **设置** 在左边的菜单中，选择 **Api和模块**: * 座 **运动ID**; * 标签 **查询日志** →块中的下拉列表 **显示日志**. ⚠️ 不要把它与: - 商店的标识符，显示在商家的个人帐户中。 - 广告活动。 _Min value:_{.json-schema-reset .json-schema-assertion} `1` {.table-cell} || || _status_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 产品状况: * `PUBLISHED` — 准备出售。 * `CHECKING` — 审查中。 * `DISABLED_BY_PARTNER` — 被你藏起来了。 * `REJECTED_BY_MARKET` — 被拒绝了。 * `DISABLED_AUTOMATICALLY` — 修正错误。 * `CREATING_CARD` — 正在创建一张卡。 * `NO_CARD` — 我需要一张卡片。 * `NO_STOCKS` — 没有存货。 * `ARCHIVED` — 在档案中。 * `READY_FOR_PUBLICATION` — 商店正在激活过程中. [每个状态意味着什么？](https://yandex.ru/support/marketplace/assortment/add/statuses.html) _Enum:_{.json-schema-reset .json-schema-value} `PUBLISHED`, `CHECKING`, `DISABLED_BY_PARTNER`, `DISABLED_AUTOMATICALLY`, `REJECTED_BY_MARKET`, `CREATING_CARD`, `NO_CARD`, `NO_STOCKS`, `ARCHIVED`, `READY_FOR_PUBLICATION` {.table-cell} || |#{.json-schema-properties} {% endcut %} 放置产品的商店列表。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "campaignId": 1, "status": "PUBLISHED" } ] ``` {% endcut %} {.table-cell} || || _cardStatus_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 产品卡状态: * `HAS_CARD_CAN_NOT_UPDATE` — 的市场卡。 * `HAS_CARD_CAN_UPDATE` — 你可以添加它。 * `HAS_CARD_CAN_UPDATE_ERRORS` — 更改尚未被接受。 * `HAS_CARD_CAN_UPDATE_PROCESSING` — 变化正在审查中。 * `NO_CARD_NEED_CONTENT` — 创建一张卡片。 * `NO_CARD_MARKET_WILL_CREATE` — 创建一个市场。 * `NO_CARD_ERRORS` — 它不是由于错误而创建的。 * `NO_CARD_PROCESSING` — 我们检查数据。 * `NO_CARD_ADD_TO_CAMPAIGN` — 将产品放在商店里。 _Enum:_{.json-schema-reset .json-schema-value} `HAS_CARD_CAN_NOT_UPDATE`, `HAS_CARD_CAN_UPDATE`, `HAS_CARD_CAN_UPDATE_ERRORS`, `HAS_CARD_CAN_UPDATE_PROCESSING`, `NO_CARD_NEED_CONTENT`, `NO_CARD_MARKET_WILL_CREATE`, `NO_CARD_ERRORS`, `NO_CARD_PROCESSING`, `NO_CARD_ADD_TO_CAMPAIGN` {.table-cell} || || _groupId_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 产品组的标识符。 组合在一起的产品将具有相同的标识符。 [如何将产品组合在卡片上](https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/assortment-add-goods.md#combine-variants) _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _mediaFiles_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object" %} #| || _firstVideoAsCover_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact} {.table-cell}| **Type**: boolean 使用卡中的第一个视频作为视频背景。 传下去 `true` 为第一视频作为视频背景，或 `false` 使视频背景不显示在产品配置文件中。 {.table-cell} || || _manuals_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _title_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 媒体文件的名称。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _uploadState_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 媒体文件下载状态: * `UPLOADING` — 装货了。 * `UPLOADED` — 上传成功。 * `FAILED` — 下载过程中发生错误。 请稍后再试。 _Enum:_{.json-schema-reset .json-schema-value} `UPLOADING`, `UPLOADED`, `FAILED` {.table-cell} || || _url_{.json-schema-reset .json-schema-property} {.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} || |#{.json-schema-properties} {% endcut %} 产品使用指南。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "url": "example", "title": "example", "uploadState": "UPLOADING" } ] ``` {% endcut %} {.table-cell} || || _pictures_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _title_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 媒体文件的名称。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _uploadState_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 媒体文件下载状态: * `UPLOADING` — 装货了。 * `UPLOADED` — 上传成功。 * `FAILED` — 下载过程中发生错误。 请稍后再试。 _Enum:_{.json-schema-reset .json-schema-value} `UPLOADING`, `UPLOADED`, `FAILED` {.table-cell} || || _url_{.json-schema-reset .json-schema-property} {.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} || |#{.json-schema-properties} {% endcut %} 产品图像。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "url": "example", "title": "example", "uploadState": "UPLOADING" } ] ``` {% endcut %} {.table-cell} || || _videos_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _title_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 媒体文件的名称。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || || _uploadState_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 媒体文件下载状态: * `UPLOADING` — 装货了。 * `UPLOADED` — 上传成功。 * `FAILED` — 下载过程中发生错误。 请稍后再试。 _Enum:_{.json-schema-reset .json-schema-value} `UPLOADING`, `UPLOADED`, `FAILED` {.table-cell} || || _url_{.json-schema-reset .json-schema-property} {.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} || |#{.json-schema-properties} {% endcut %} 产品的视频文件。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "url": "example", "title": "example", "uploadState": "UPLOADING" } ] ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% endcut %} 有关产品的媒体文件的信息。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "firstVideoAsCover": true, "videos": [ { "url": "example", "title": "example", "uploadState": "UPLOADING" } ], "pictures": [ { "url": "example", "title": "example", "uploadState": "UPLOADING" } ], "manuals": [ { "url": "example", "title": "example", "uploadState": "UPLOADING" } ] } ``` {% endcut %} {.table-cell} || || _purchasePrice_{.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 #| || _updatedAt_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string<date-time> 上次更新的时间。 _Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z` {.table-cell} || |#{.json-schema-properties} 上次更新的时间。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "updatedAt": "2025-01-01T00:00:00Z" } ``` {% endcut %} {% endcut %} 指示上次更新时间的价格。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "value": 0, "currencyId": "RUR", "updatedAt": "2025-01-01T00:00:00Z" } ``` {% endcut %} {.table-cell} || || _sellingPrograms_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _sellingProgram_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 工作模式: * `FBY` — FBY. * `FBS` — FBS. * `DBS` — DBS. * `EXPRESS` — Express. * `LAAS` — 拉斯。 _Enum:_{.json-schema-reset .json-schema-value} `FBY`, `FBS`, `DBS`, `EXPRESS`, `LAAS` {.table-cell} || || _status_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 可用性或不可用性的信息。 * `FINE` — 可用。 * `REJECT` — 不可用。 _Enum:_{.json-schema-reset .json-schema-value} `FINE`, `REJECT` {.table-cell} || |#{.json-schema-properties} {% endcut %} 有关产品可用的放置模型的信息。 _Min items:_{.json-schema-reset .json-schema-assertion} `1` {% cut "**Example**" %}{.json-schema-example} ```json translate=no [ { "sellingProgram": "FBY", "status": "FINE" } ] ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "basicPrice": { "value": 0, "currencyId": "RUR", "discountBase": 0, "updatedAt": "2025-01-01T00:00:00Z" }, "purchasePrice": { "value": 0, "currencyId": "RUR", "updatedAt": "2025-01-01T00:00:00Z" }, "additionalExpenses": { "value": 0, "currencyId": "RUR", "updatedAt": "2025-01-01T00:00:00Z" }, "cardStatus": "HAS_CARD_CAN_NOT_UPDATE", "campaigns": [ { "campaignId": 1, "status": "PUBLISHED" } ], "sellingPrograms": [ { "sellingProgram": "FBY", "status": "FINE" } ], "mediaFiles": { "firstVideoAsCover": true, "videos": [ { "url": "example", "title": "example", "uploadState": "UPLOADING" } ], "pictures": [ { "url": "example", "title": "example", "uploadState": "UPLOADING" } ], "manuals": [ { "url": "example", "title": "example", "uploadState": "UPLOADING" } ] }, "archived": true, "groupId": "example" } ``` {% 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": "есть" } ], "basicPrice": { "value": 0, "currencyId": "RUR", "discountBase": 0, "updatedAt": "2025-01-01T00:00:00Z" }, "purchasePrice": { "value": 0, "currencyId": "RUR", "updatedAt": "2025-01-01T00:00:00Z" }, "additionalExpenses": { "value": 0, "currencyId": "RUR", "updatedAt": "2025-01-01T00:00:00Z" }, "cardStatus": "HAS_CARD_CAN_NOT_UPDATE", "campaigns": [ { "campaignId": 1, "status": "PUBLISHED" } ], "sellingPrograms": [ { "sellingProgram": "FBY", "status": "FINE" } ], "mediaFiles": { "firstVideoAsCover": true, "videos": [ { "url": "example", "title": "example", "uploadState": "UPLOADING" } ], "pictures": [ { "url": "example", "title": "example", "uploadState": "UPLOADING" } ], "manuals": [ { "url": "example", "title": "example", "uploadState": "UPLOADING" } ] }, "archived": true, "groupId": "example" } ``` {% endcut %} {.table-cell} || || _showcaseUrls_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object[]" %} #| || _showcaseType_{.json-schema-reset .json-schema-property .json-schema-required} {.table-cell}| **Type**: string 展柜类型: * `B2B` — [Yandex业务市场](https://business.market.yandex.ru/) （法人和独资经营者的产品）。 阅读更多有关服务的资料 [救命！](https://yandex.ru/support/market-for-enterprise/ru/). * `B2C` — [市场的主要展示](https://market.yandex.ru/) （个人商品）。 _Enum:_{.json-schema-reset .json-schema-value} `B2B`, `B2C` {.table-cell} || || _showcaseUrl_{.json-schema-reset .json-schema-property .json-schema-required} {.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 [ { "showcaseType": "B2B", "showcaseUrl": "example" } ] ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% endcut %} 有关产品的信息。 {% 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": [ {} ], "basicPrice": {}, "purchasePrice": {}, "additionalExpenses": {}, "cardStatus": "HAS_CARD_CAN_NOT_UPDATE", "campaigns": [ {} ], "sellingPrograms": [ {} ], "mediaFiles": { "firstVideoAsCover": true, "videos": [ null ], "pictures": [ null ], "manuals": [ null ] }, "archived": true, "groupId": "example" }, "mapping": { "marketSku": 1, "marketSkuName": "example", "marketModelName": "example", "marketCategoryId": 0, "marketCategoryName": "example" }, "showcaseUrls": [ { "showcaseType": "B2B", "showcaseUrl": "example" } ] } ] ``` {% endcut %} {.table-cell} || || _paging_{.json-schema-reset .json-schema-property} {.table-cell}| {% cut "**Type**: object" %} #| || _nextPageToken_{.json-schema-reset .json-schema-property} {.table-cell}| **Type**: string 下一个结果页面的ID。 _Example:_{.json-schema-reset .json-schema-example} `example` {.table-cell} || |#{.json-schema-properties} {% endcut %} 下一页的ID。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "nextPageToken": "example" } ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% endcut %} 有关产品的信息。 {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "paging": { "nextPageToken": "example" }, "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 ], "basicPrice": {}, "purchasePrice": {}, "additionalExpenses": {}, "cardStatus": "HAS_CARD_CAN_NOT_UPDATE", "campaigns": [ null ], "sellingPrograms": [ null ], "mediaFiles": {}, "archived": true, "groupId": "example" }, "mapping": { "marketSku": 1, "marketSkuName": "example", "marketModelName": "example", "marketCategoryId": 0, "marketCategoryName": "example" }, "showcaseUrls": [ { "showcaseType": "B2B", "showcaseUrl": "example" } ] } ] } ``` {% endcut %} {.table-cell} || |#{.json-schema-properties} {% endcut %} {% cut "**Example**" %}{.json-schema-example} ```json translate=no { "result": { "paging": { "nextPageToken": "example" }, "offerMappings": [ { "offer": {}, "mapping": {}, "showcaseUrls": [ {} ] } ] } } ``` {% endcut %} {% endcut %}

## 400 Bad Request 请求包含不正确的数据。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#400)
### 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 %}
## 500 Internal Server Error 市场的内部错误。 [有关错误的更多信息](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: - name: pageToken description: | 结果页面的ID。 如果省略该参数，则返回第一页。 传递输出参数的值 `nextPageToken`，在最后一次请求期间接收。 in: query required: false x-transform: token x-aliases: - pageToken - page_token schema: type: string - name: limit description: | 每页的值数。

如果参数值超过允许的最大值，它将减少到最大值。 in: query required: false x-transform: truncateLimit schema: type: integer format: int32 minimum: 1 default: 50 maximum: 100 - description: | 接受和返回参数中的值的语言 `name` 和 `description`. 默认值: `RU`. name: language in: query required: false schema: description: | 语言: * `RU` — 俄语。 * `UZ` — 乌兹别克。 type: string enum: - RU - UZ headers: [] body: |- { "offerIds": [ "example" ], "cardStatuses": [ "HAS_CARD_CAN_NOT_UPDATE" ], "categoryIds": [ 0 ], "vendorNames": [ "example" ], "tags": [ "example" ], "archived": true } schema: type: object properties: offerIds: description: "需要信息的产品的Id。\n\n\n:::no-translate\n{% note warning \"Такой список возвращается только целиком\" %}\n:::\n\n\n如果你要求提供特定的资料 SKU，不填写:\n* `pageToken`;\n* `limit`;\n* `cardStatuses`;\n* `categoryIds`;\n* `vendorNames`;\n* `tags`;\n* `archived`.\n\n\n:::no-translate\n{% endnote %}\n:::\n\n\n\_\n" type: array nullable: true minItems: 1 maxItems: 100 uniqueItems: true items: 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 cardStatuses: description: > 按卡状态过滤。 [什么是产品卡？](https://yandex.ru/support/marketplace/assortment/content/index.html) type: array nullable: true minItems: 1 uniqueItems: true items: description: > 产品卡状态: * `HAS_CARD_CAN_NOT_UPDATE` — 的市场卡。 * `HAS_CARD_CAN_UPDATE` — 你可以添加它。 * `HAS_CARD_CAN_UPDATE_ERRORS` — 更改尚未被接受。 * `HAS_CARD_CAN_UPDATE_PROCESSING` — 变化正在审查中。 * `NO_CARD_NEED_CONTENT` — 创建一张卡片。 * `NO_CARD_MARKET_WILL_CREATE` — 创建一个市场。 * `NO_CARD_ERRORS` — 它不是由于错误而创建的。 * `NO_CARD_PROCESSING` — 我们检查数据。 * `NO_CARD_ADD_TO_CAMPAIGN` — 将产品放在商店里。 type: string enum: - HAS_CARD_CAN_NOT_UPDATE - HAS_CARD_CAN_UPDATE - HAS_CARD_CAN_UPDATE_ERRORS - HAS_CARD_CAN_UPDATE_PROCESSING - NO_CARD_NEED_CONTENT - NO_CARD_MARKET_WILL_CREATE - NO_CARD_ERRORS - NO_CARD_PROCESSING - NO_CARD_ADD_TO_CAMPAIGN categoryIds: description: 在市场上按类别过滤。 type: array nullable: true minItems: 1 uniqueItems: true items: type: integer format: int32 minimum: 0 exclusiveMinimum: true vendorNames: description: 按品牌过滤。 type: array nullable: true minItems: 1 uniqueItems: true items: type: string tags: description: 按标签过滤。 type: array nullable: true minItems: 1 uniqueItems: true items: type: string archived: description: > 按存档中的位置过滤。 传下去 `true` 以接收存档中的项目。 如果过滤器未填充或通过 `false`，响应返回不在存档中的项。 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 host: https://api.partner.market.yandex.ru ``` {% endlist %}
[*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协会并注册产品。 [*Deprecated]: No longer supported, please use an alternative and newer version.