在目录中添加和编辑产品
Deprecated
Info
Console
方法适用于所有模式.
如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一
- offers-and-cards-management — 商品和卡片管理
- all-methods — 全面管理账户
我应该使用哪种方法而不是过时的方法？
将请求中指定的产品添加到产品目录并编辑现有产品。
有关产品的信息必须在体内传递 POST-请求。
每个产品必须有您的 SKU — 用于识别产品的唯一代码:
- 要向目录中添加新产品，请在参数中指定
shopSku你的 SKU，这是尚未在目录中。 - 若要编辑目录中的项，请在参数中指定
shopSku你的 SKU 这种产品在目录中.
在这两种情况下，您都需要在请求中提供完整的产品描述，即使您只想更改一些特征。
如果您知道市场上的哪种产品卡对应于您的产品，请指定其ID（SKU 在市场上）在输入参数 mapping. 接收 SKU 您可以通过您的帐户访问市场上的推荐产品卡。 如果 SKU 它没有上市，市场工作人员会自己选择或创建一个合适的产品卡，或者它会有一个地位 NEED_CONTENT （您需要找到卡或自己创建它）在请求输出中 POST v2/businesses/{businessId}/offer-mappings.
产品在出版前经过审核. 如果在其中一个已发送的项目中发现错误，则对请求的响应将具有HTTP代码。 400 Bad Request，并且没有任何产品将提交审核。 但是，如果您没有传递任何产品的所有必需参数，它将具有审核后的状态。 NEED_INFO （产品描述中没有足够的信息）在请求输出中 POST v2/businesses/{businessId}/offer-mappings.
每个请求最多可以添加500个产品。
目录中的数据不会立即更新
最多需要几分钟。
| ⚙️ 限制: 每分钟5,000件物品 |
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/offer-mapping-entries/updates
Path parameters
|
Name |
Description |
|
campaignId |
Type: integer 广告系列（商店）的ID — 通过API工作时，代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接，但仅用于自动交互。 您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中，选择 Api和模块:
⚠️ 不要把它与:
Min value: |
Body
application/json
{
"offerMappingEntries": [
{
"offer": {}
}
]
}
|
Name |
Description |
|
offerMappingEntries |
Type: object[] 目录中有关产品的信息。 Min items: Max items: Example |
Responses
200 OK
操作的状态。
Body
application/json
{
"status": "OK"
}
Type: object
500 Internal Server Error
Yandex的内部错误。 市场。 有关错误的更多信息
Body
application/json
{
"status": "OK"
}
Type: object
pathParams:
- description: "广告系列（商店）的ID — 通过API工作时，代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接，但仅用于自动交互。\n\n您可以使用查询找到它 [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md) 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ **设置** 在左边的菜单中，选择 **Api和模块**:\n\n* 座 **运动ID**;\n* 标签 **查询日志** →块中的下拉列表 **显示日志**.\n\n⚠️ 不要把它与:\n- 商店的标识符，显示在商家的个人帐户中。\n- 广告活动。\n"
name: campaignId
in: path
required: true
schema:
type: integer
format: int64
minimum: 1
searchParams: []
headers: []
body: |-
{
"offerMappingEntries": [
{
"offer": {}
}
]
}
schema:
description: 请求产品更新。
type: object
required:
- offerMappingEntries
properties:
offerMappingEntries:
description: 目录中有关产品的信息。
type: array
minItems: 1
maxItems: 500
items:
description: |
的产品清单。
type: object
allOf:
- properties:
offer:
description: 目录中有关产品的信息。
type: object
allOf:
- description: 目录中有关产品的基本信息。
type: object
properties:
name:
description: >
根据方案组成名称：类型+品牌或制造商+型号+功能，如果有（例如，颜色，尺寸或重量）和数量在包装中。
不包括情感特征（"命中"，"超级"等。）以销售条款的名义（例如，"折扣"，"免费送货"等。).
不要用大写字母写单词。 — 除了成熟的品牌名称和型号。
最佳长度 — 50-60个字符。
[建议和规则](https://yandex.ru/support/marketplace/assortment/fields/title.html)
example: Ударная дрель Makita HP1630, 710 Вт
type: string
maxLength: 256
shopSku:
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{% note warning %}\n\n值开头和结尾的空格会自动删除。 例如, `\" SKU123 \"` 和 `\"SKU123\"` 它们将被视为相同的值。\n\n{% endnote %}\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
category:
description: "{% note warning \"相反，使用 `marketCategoryId`.\" %}\n\n\_\n\n{% endnote %}\n\n您商店中的产品类别。\n"
type: string
deprecated: true
vendor:
description: 品牌或制造商的名称。 它应该按照品牌本身的方式来写。
example: LEVENHUK
type: string
vendorCode:
description: 从制造商的产品的文章。
example: VNDR-0005A
type: string
description:
description: >
详细的产品说明：例如，它的优点和特点。
说明中不提供安装和装配说明。
不要使用"折扣"，"销售"，"便宜"，"礼品"（礼品类别除外），"免费"，"特价"，"特价"，"新奇"，"新"，"模拟"，"订单"，"点击"等字样。
不要提供任何联系信息或链接。
您可以使用HTML标记来格式化文本:
* \<h>，\<h1>，\<h2>等等 — 新闻标题;
* \<br>和\<p> — 对于换行符;
* \<ol> — 对于编号列表;
* \<ul> — 对于项目符号列表。
* \<李> — 创建列表项（必须在\<ol>或\<ul>内）;
* \<div> — 支持，但不影响文本显示。
最佳长度 — 400-600个字符。
[建议和规则](https://yandex.ru/support/marketplace/assortment/fields/description.html)
type: string
maxLength: 6000
id:
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{% note warning %}\n\n值开头和结尾的空格会自动删除。 例如, `\" SKU123 \"` 和 `\"SKU123\"` 它们将被视为相同的值。\n\n{% endnote %}\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
feedId:
description: 的feed ID。
type: integer
format: int64
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
type: array
nullable: true
minItems: 1
uniqueItems: true
items:
type: string
example: '46012300000000'
urls:
description: |
URL 您网站上的产品照片或描述页面。
传输的数据不会显示在展柜上，但它将帮助市场专家为您的产品找到一张卡片。
必须包含一个嵌套参数。 `url`.
type: array
nullable: true
minItems: 1
uniqueItems: true
items:
type: string
minLength: 1
maxLength: 2000
pictures:
description: >
连结(URL）产品图像质量好。
您最多可以指定30个链接。 在这种情况下，第一个链接上的图像将是主要的。
它被用作市场搜索和产品卡上的产品图像。 放大图像视图中提供其他产品图像。
type: array
nullable: true
minItems: 1
maxItems: 30
uniqueItems: false
items:
type: string
minLength: 1
maxLength: 2000
manufacturer:
description: |
产品制造商：生产该产品的公司，其地址和注册号（如果有的话）。
可选参数。
type: string
manufacturerCountries:
description: |
生产产品的国家列表。
所需参数。
它必须包含至少一个，但不超过5个国家。
type: array
nullable: true
minItems: 1
maxItems: 5
uniqueItems: true
items:
type: string
minShipment:
description: |
交付到仓库的最小物料数。
例如，如果您以至少10个盒子的批次供应婴儿食品，并且每个盒子包含6个罐子，请指定值60。
type: integer
format: int32
transportUnitSize:
description: |
您交付到仓库的一个包中的物料数量。
例如，如果您以6罐的盒子供应婴儿食品，请指定值6。
type: integer
format: int32
quantumOfSupply:
deprecated: true
description: |
附加批次：最小数量可以添加多少项 `minShipment`.
例如，如果您以至少10盒的批次供应婴儿食品，并希望在最小批次中添加2盒，每盒中有6个罐子，请指定值12。
type: integer
format: int32
deliveryDurationDays:
description: 卖方将货物交付仓库的期限，以天为单位。
type: integer
format: int32
boxCount:
description: >
产品占用多少个座位（如果超过一个）。
仅当产品占据多于一个位置（例如，空调占据两个位置：两个盒子中的外部和内部单元）时才指定该参数。
如果产品占据一个位置，请不要指定此参数。
type: integer
format: int32
customsCommodityCodes:
description: |
对外经济活动统一商品命名法（HS）中的产品代码列表。
如果产品需要进行特殊核算（例如，在汞系统中作为动物来源的产品或诚实标志系统中），则为强制性参数。
它只能包含一个嵌套HS代码。
type: array
nullable: true
minItems: 1
uniqueItems: true
items:
type: string
weightDimensions:
description: >
包装的尺寸和产品的重量。
如果产品占用几个盒子，在测量尺寸之前将它们紧凑地折叠起来。
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
supplyScheduleDays:
description: 卖方将货物交付到仓库的一周中的几天。
type: array
nullable: true
minItems: 1
uniqueItems: true
items:
description: |
星期几:
* `MONDAY` — 星期一。
* `TUESDAY` — 星期二。
* `WEDNESDAY` — 星期三。
* `THURSDAY` — 星期四。
* `FRIDAY` — 星期五。
* `SATURDAY` — 星期六。
* `SUNDAY` — 星期天。
type: string
enum:
- MONDAY
- TUESDAY
- WEDNESDAY
- THURSDAY
- FRIDAY
- SATURDAY
- SUNDAY
shelfLifeDays:
description: "{% note warning \"相反，使用 `shelfLife`. 同时使用这两个参数将导致错误。\" %}\n\n\_\n\n{% endnote %}\n\n到期日期：经过多少天的产品将变得不可用。\n"
type: integer
format: int32
deprecated: true
lifeTimeDays:
description: "{% note warning \"相反，使用 `lifeTime`. 同时使用这两个参数将导致错误。\" %}\n\n\_\n\n{% endnote %}\n\n使用寿命：产品正常运行多少天，制造商 — 对其显着缺点负责。\n"
type: integer
format: int32
deprecated: true
guaranteePeriodDays:
description: |
产品保修期：多少天可以服务和修理产品或退款，制造商或销售商将对产品的缺陷负责。
type: integer
format: int32
processingState:
description: 品在市场上的发布状态的信息。
type: object
properties:
status:
description: >
产品发布状态:
* `UNKNOWN` — 状态不明。
* `READY` —
该产品已通过审核。 要将其投放市场，请为其设定价格。
* `IN_WORK` —
该产品正在进行适度。 这需要几天的时间。
* `NEED_INFO` —
由于产品描述中的错误或信息缺失，产品审核失败。 参数中返回有关偏差原因的信息
`notes`.
* `NEED_MAPPING` —
您无法为产品创建卡片。
* `NEED_CONTENT` —
对于没有的产品 SKU
在市场上（`marketSku`）您需要自己找到卡（通过API或市场上的卖家帐户），或者如果产品尚未在市场上销售，则创建它。
* `CONTENT_PROCESSING`
— 该产品正在适度。
* `SUSPENDED` —
该产品尚未通过审核，因为市场尚未放置此类产品。
* `REJECTED` —
该产品没有通过审核，因为市场不打算发布此类产品。
* `REVIEW` —
正在就产品的放置做出决定。
* `CREATE_ERROR` —
无法创建产品配置文件。
* `UPDATE_ERROR` —
产品卡有未使用的更改。
type: string
enum:
- UNKNOWN
- READY
- IN_WORK
- NEED_INFO
- NEED_MAPPING
- NEED_CONTENT
- CONTENT_PROCESSING
- SUSPENDED
- REJECTED
- REVIEW
- CREATE_ERROR
- UPDATE_ERROR
notes:
description: 产品审核失败的原因。
type: array
nullable: true
minItems: 1
items:
description: 产品审核失败的原因。
type: object
properties:
type:
description: "产品审核失败的原因类型:\n\n* `ASSORTMENT` — 该产品以不同的版本生产。 它们中的每一个都应该被描述为一个单独的产品（参数 `offerMappings` 在请求 [POST\_v2/businesses/{businessId}/offer-mappings/update](../../reference/business-assortment/updateOfferMappings.md) 或目录中的一行，如果您通过市场上的卖家帐户上传产品）。\n* `CANCELLED` — 该产品是在你的主动下退出的.\n* `CONFLICTING_INFORMATION` _（以前错误地 `CONFLICTING`)_ — 您提供了有关产品的冲突信息。 需要修复的参数在参数中指定 `payload`.\n* `OTHER` — 由于另一个原因，该产品未能审核。 联系客户支持或您的经理。\n* `DEPARTMENT_FROZEN` — 在此类别中放置产品的规则正在处理中，因此该产品还不能通过审核。\n* `INCORRECT_INFORMATION` — 您提供的产品信息与制造商的描述相矛盾。 需要修复的参数在参数中指定 `payload`.\n* `LEGAL_CONFLICT` — 由于法律原因，该产品未通过审核。 例如，它没有在俄罗斯正式销售，或者你没有许可证出售它。\n* `NEED_CLASSIFICATION_INFORMATION` — 您提供的有关产品的信息不足以对其进行分类。 确保您已正确指定产品的名称，类别，制造商和制造国家，以及 URL 带有可用于识别产品的描述的图像或页面。\n* `NEED_INFORMATION` — 该产品之前尚未在俄罗斯销售，目前尚未上市。 你可以为它创建一张卡片。 有关更多信息，请参阅部分 [使用产品卡](https://yandex.ru/support/marketplace/assortment/content/index.html) 燕基科斯. 卖家的市场帮助。\n* `NEED_PICTURES` — 要识别产品，您需要其图像。 发送出去 URL 请求中的产品图像 [POST\_v2/businesses/{businessId}/offer-mappings/update](../../reference/business-assortment/updateOfferMappings.md) 或者通过市场上的卖家账户下载更新的目录。\n* `NEED_VENDOR` — 产品制造商指定不正确。\n* `NO_CATEGORY`, `NO_KNOWLEDGE` — 该类别的产品尚未投放市场。 如果出现类别，产品将再次发送审核。\n* `NO_PARAMETERS_IN_SHOP_TITLE` — 该产品以不同的版本生产，并且从名称中不清楚它是关于哪一个。 要添加到产品名称的参数在参数中指定 `payload`.\n* `NO_SIZE_MEASURE` — 您需要此产品的尺寸网格。 将其发送给支持服务或您的经理。 尺寸网格要求在参数中指定 `payload`.\n* `SAMPLE_LINE` — 由于多了一条线,该产品没有通过审核.\n"
type: string
enum:
- ASSORTMENT
- CANCELLED
- CONFLICTING_INFORMATION
- OTHER
- DEPARTMENT_FROZEN
- INCORRECT_INFORMATION
- LEGAL_CONFLICT
- NEED_CLASSIFICATION_INFORMATION
- NEED_INFORMATION
- NEED_PICTURES
- NEED_VENDOR
- NO_CATEGORY
- NO_KNOWLEDGE
- NO_PARAMETERS_IN_SHOP_TITLE
- NO_SIZE_MEASURE
- SAMPLE_LINE
payload:
description: |
有关产品拒绝原因的其他信息。
type: string
availability:
description: >
送货计划:
* `ACTIVE` — 会有送货的。
* `INACTIVE` —
不会有交付：产品有库存，但您不再计划交付。 产品缺货60天后，此状态将更改为
`DELISTED`.
* `DELISTED` —
存档：该产品已缺货，将不再有交付。 如果产品退回仓库（例如，客户退回订单），则此状态将更改为
`INACTIVE`.
type: string
enum:
- ACTIVE
- INACTIVE
- DELISTED
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
certificate:
description: >
产品的文档编号。
在指定号码之前，必须将文档上传到市场上的卖家帐户。
[指示手册](https://yandex.ru/support/marketplace/assortment/restrictions/certificates.html)
type: string
- description: 品卡的信息。
type: object
properties:
mapping:
description: 有关市场上当前产品简介的信息。
type: object
properties:
marketSku:
description: 市场上的产品卡的ID。
type: integer
format: int64
minimum: 1
modelId:
x-hidden: true
description: >
市场上当前产品配置文件的型号ID。
例如，两个不同颜色的刀片具有不同的 SKU 在市场上（参数
`marketSku`），但相同的产品型号ID。
type: integer
format: int64
categoryId:
description: 市场上当前产品配置文件的类别ID。
type: integer
format: int64
awaitingModerationMapping:
description: 有关市场上当前产品简介的信息。
type: object
properties:
marketSku:
description: 市场上的产品卡的ID。
type: integer
format: int64
minimum: 1
modelId:
x-hidden: true
description: >
市场上当前产品配置文件的型号ID。
例如，两个不同颜色的刀片具有不同的 SKU 在市场上（参数
`marketSku`），但相同的产品型号ID。
type: integer
format: int64
categoryId:
description: 市场上当前产品配置文件的类别ID。
type: integer
format: int64
rejectedMapping:
description: 有关市场上当前产品简介的信息。
type: object
properties:
marketSku:
description: 市场上的产品卡的ID。
type: integer
format: int64
minimum: 1
modelId:
x-hidden: true
description: >
市场上当前产品配置文件的型号ID。
例如，两个不同颜色的刀片具有不同的 SKU 在市场上（参数
`marketSku`），但相同的产品型号ID。
type: integer
format: int64
categoryId:
description: 市场上当前产品配置文件的类别ID。
type: integer
format: int64
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/campaigns/{campaignId}/offer-mapping-entries/updates
host: https://api.partner.market.yandex.ru
No longer supported, please use an alternative and newer version.
什么是GTIN？
[医]GTIN — 这是在单个国际数据库中分配给产品的唯一编号。 GS1. 此编号生成EAN、UPC或ISBN条形码。
如何确保产品在数据库中
你可以在 验证页面 在GS1协会的网站上。 如果未找到产品，请向供应商索取GTIN代码。
如何为您的产品获取GTIN
要接收GTIN代码，制造商需要加入GS1协会并注册产品。