目录中的产品列表
方法适用于所有模式.
如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一
我应该使用哪种方法而不是过时的方法？
对于您放置在市场上的每个产品，将返回有关此产品链接到的市场卡的信息:
- 当前卡（marketSku）的ID，正在进行审核的卡以及最后被拒绝的卡。
- 市场卡上显示的产品说明。 例如，包装的尺寸和产品的重量。
结果逐页返回。 输出数据包含下一页的ID。
商店目录中的产品数量是如何计算的?
根据最近七天（不包括今天）的数据。
| ⚙️ 限制: 每分钟10,000件物品 |
|---|
Request
GET
https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/offer-mapping-entries
Path parameters
|
Name |
Description |
|
campaignId* |
Type: integer<int64> 活动ID。 您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到 — 点击您的帐户图标→ 设置 在左边的菜单中，选择 Api和模块:
⚠️ 不要发送商店ID，这是在市场上的卖家帐户旁边的商店名称和一些报告。
Min value: |
Query parameters
|
Name |
Description |
|
availability |
Type: string[] 按产品交付计划过滤:
您可以在一个参数中指定多个值，用逗号分隔，也可以在几个相同的参数中指定多个值。 例如: 在请求中，您可以指定参数
Enum: |
|
category_id |
Type: integer[] 通过市场上的类别ID进行过滤。 要找出产品所属类别的ID，请使用请求 POST v2/categories/tree. 您可以在一个参数中指定多个标识符（用逗号分隔），也可以在几个相同的参数中指定多个标识符。 例如: 在请求中，您可以指定参数 |
|
limit |
Type: integer<int32> 每页的值数。
Min value: |
|
mapping_kind |
Type: string 映射的类型。
Enum: |
|
offer_id |
Type: string[] 目录中的产品ID。 |
|
page_token |
Type: string 结果页面的ID。 如果省略该参数，则返回第一页。 我们建议传输输出参数的值 如果设置 |
|
shop_sku |
Type: string[] 你的 SKU 的产物。 该参数可以指定多次，例如: 在请求中，您可以指定参数 使用规则 SKU:
SKU 产品可以在市场上的卖方帐户中更改。 阅读有关如何做到这一点。 在市场对卖家的帮助. 重要 值开头和结尾的空格会自动删除。 例如, Min length: Max length: Pattern: |
|
status |
Type: string[] 按产品发布状态过滤:
您可以在一个参数中指定多个状态（以逗号分隔），也可以在多个相同的参数中指定多个状态。 例如: 请求可以指定shopSku参数或用于筛选产品的任何参数。 同时使用shopSku参数和过滤参数将导致错误。
Enum: |
|
vendor |
Type: string[] 按产品品牌过滤。 您可以在一个参数中指定多个品牌，以逗号分隔，也可以在几个相同的参数中指定多个品牌。 例如: 为了将产品包含在过滤结果中，其品牌必须与请求中指定的品牌之一完全匹配。 例如，如果指定了品牌 Schwarzkopf，那么结果中就没有产品了 Schwarzkopf Professional. 如果品牌名称包含表中未包含的字符 ASCII （包括西里尔字符），用于它们 URL-编码。 例如，一个空间 — %20,撇号"'" — %27等。 有关详细信息，请参阅 编码 URL 俄语维基百科. 请求可以指定shopSku参数或用于筛选产品的任何参数。 共享参数 |
Responses
200 OK
目录中有关产品的信息。
Body
application/json
{
"status": "OK",
"result": {
"paging": {
"nextPageToken": "string",
"prevPageToken": "string"
},
"offerMappingEntries": [
{
"offer": {
"name": "Ударная дрель Makita HP1630, 710 Вт",
"shopSku": "string",
"category": "string",
"vendor": "LEVENHUK",
"vendorCode": "VNDR-0005A",
"description": "string",
"id": "string",
"feedId": 0,
"barcodes": [
"46012300000000"
],
"urls": [
"string"
],
"pictures": [
"string"
],
"manufacturer": "string",
"manufacturerCountries": [
"string"
],
"minShipment": 0,
"transportUnitSize": 0,
"quantumOfSupply": 0,
"deliveryDurationDays": 0,
"boxCount": 0,
"customsCommodityCodes": [
"string"
],
"weightDimensions": {
"length": 65.55,
"width": 50.7,
"height": 20,
"weight": 1.001
},
"supplyScheduleDays": [
"MONDAY"
],
"shelfLifeDays": 0,
"lifeTimeDays": 0,
"guaranteePeriodDays": 0,
"processingState": {
"status": "UNKNOWN",
"notes": [
{
"type": "ASSORTMENT",
"payload": "string"
}
]
},
"availability": "ACTIVE",
"shelfLife": {
"timePeriod": 0,
"timeUnit": "HOUR",
"comment": "string"
},
"lifeTime": {
"timePeriod": 0,
"timeUnit": "HOUR",
"comment": "string"
},
"guaranteePeriod": {
"timePeriod": 0,
"timeUnit": "HOUR",
"comment": "string"
},
"certificate": "string",
"price": 0
},
"mapping": {
"marketSku": 0,
"modelId": 0,
"categoryId": 0
},
"awaitingModerationMapping": {
"marketSku": 0,
"modelId": 0,
"categoryId": 0
},
"rejectedMapping": {
"marketSku": 0,
"modelId": 0,
"categoryId": 0
}
}
]
}
}
|
Name |
Description |
||||||||
|
status* |
Type: string 响应的类型。 可能的值:
Enum: |
||||||||
|
result |
Type: object
目录中有关产品的信息。 |
400 Bad Request
请求包含不正确的数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
401 Unauthorized
请求中未指定授权数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
403 Forbidden
授权数据不正确或禁止访问资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
404 Not Found
找不到请求的资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
420 Method Failure
已超出资源访问限制。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
500 Internal Server Error
市场的内部错误。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
No longer supported, please use an alternative and newer version.
什么是GTIN？
[医]GTIN — 这是在单个国际数据库中分配给产品的唯一编号。 GS1. 此编号生成EAN、UPC或ISBN条形码。
如何确保产品在数据库中
你可以在 验证页面 在GS1协会的网站上。 如果未找到产品，请向供应商索取GTIN代码。
如何为您的产品获取GTIN
要接收GTIN代码，制造商需要加入GS1协会并注册产品。