目录中的产品列表
Deprecated
方法适用于所有模式.
如果您使用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 广告系列(商店)的ID — 通过API工作时,代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接,但仅用于自动交互。 您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:
⚠️ 不要把它与:
Min value: |
Query parameters
|
Name |
Description |
|
availability |
Type: string[] 按产品交付计划过滤:
您可以在一个参数中指定多个值,用逗号分隔,也可以在几个相同的参数中指定多个值。 例如:
在请求中,您可以指定参数 Unique items: Example: `` |
|
category_id |
Type: integer[] 通过市场上的类别ID进行过滤。 要找出产品所属类别的ID,请使用请求 POST v2/categories/tree. 您可以在一个参数中指定多个标识符(用逗号分隔),也可以在几个相同的参数中指定多个标识符。 例如:
在请求中,您可以指定参数 Unique items: Example: `` |
|
limit |
Type: integer 每页的值数。 Min value: |
|
mapping_kind |
Type: string 映射的类型。 映射类型:
Enum: |
|
offer_id |
Type: string[] 目录中的产品Id。 Unique items: Example: `` |
|
page_token |
Type: string 结果页面的ID。 如果省略该参数,则返回第一页。 我们建议传输输出参数的值 如果设置 Example: |
|
shop_sku |
Type: string[] 目录中的产品Id。 使用参数 Unique items: Example: `` |
|
status |
Type: string[] 按产品发布状态过滤:
您可以在一个参数中指定多个状态(以逗号分隔),也可以在多个相同的参数中指定多个状态。 例如:
在请求中,您可以指定shopSku参数或用于筛选产品的任何参数。 同时使用shopSku参数和过滤参数将导致错误。 Unique items: Example: `` |
|
vendor |
Type: string[] 按产品品牌过滤。 您可以在一个参数中指定多个品牌,用逗号分隔,也可以在几个相同的参数中指定多个品牌。 例如:
为了将产品包含在过滤结果中,其品牌必须与请求中指定的品牌之一完全匹配。 例如,如果指定了品牌 Schwarzkopf,那么结果中就没有产品了 Schwarzkopf Professional. 如果品牌名称包含表中未包含的字符 ASCII (包括西里尔字符),用于它们 URL-编码。 例如,一个空间 — %20,撇号"'" — %27等。 有关详细信息,请参阅 编码 URL 俄语维基百科. 在请求中,您可以指定shopSku参数或用于筛选产品的任何参数。 共享参数 Unique 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:
- name: offer_id
in: query
x-transform: trim
required: false
description: 目录中的产品Id。
schema:
type: array
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{% 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
- name: shop_sku
in: query
x-transform: trim
required: false
deprecated: true
description: |
目录中的产品Id。
使用参数 `offer_id` 而不是这个参数。
schema:
type: array
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{% 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
- description: 映射的类型。
name: mapping_kind
in: query
required: false
schema:
description: |
映射类型:
* `ALL` — 所有产品。
* `ACTIVE` — 即卖产品。
type: string
enum:
- ACTIVE
- ALL
- description: >
按产品发布状态过滤:
* `READY` — 该产品已通过审核。
* `IN_WORK` — 该产品正在进行适度。
* `NEED_CONTENT` — 对于没有的产品
SKU 在市场上 `marketSku` 您需要自己找到一张卡或创建一张卡。
* `NEED_INFO` — 由于产品描述中的错误或信息缺失,产品审核失败。
* `REJECTED` — 该产品没有通过审核,因为市场不打算发布此类产品。
* `SUSPENDED` — 该产品尚未通过审核,因为市场尚未放置此类产品。
* `OTHER` — 由于另一个原因,该产品未能审核。
您可以在一个参数中指定多个状态(以逗号分隔),也可以在多个相同的参数中指定多个状态。 例如:
```text translate=no
...status=READY,IN_WORK...
...status=READY&status=IN_WORK...
```
在请求中,您可以指定shopSku参数或用于筛选产品的任何参数。 同时使用shopSku参数和过滤参数将导致错误。
name: status
in: query
required: false
schema:
type: array
uniqueItems: true
items:
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
- description: >
按产品交付计划过滤:
* `ACTIVE` — 会有送货的。
* `INACTIVE` — 不会有交付:产品有库存,但您不再计划交付。
* `DELISTED` — 存档:该产品已缺货,将不再有交付。
您可以在一个参数中指定多个值,用逗号分隔,也可以在几个相同的参数中指定多个值。 例如:
```text translate=no
...availability=INACTIVE,DELISTED...
...availability=INACTIVE&availability=DELISTED...
```
在请求中,您可以指定参数 `shopSku`,或用于过滤产品的任何参数。 共享参数
`shopSku` 和过滤选项将导致错误。
name: availability
in: query
required: false
schema:
type: array
uniqueItems: true
items:
description: >
送货计划:
* `ACTIVE` — 会有送货的。
* `INACTIVE` — 不会有交付:产品有库存,但您不再计划交付。
产品缺货60天后,此状态将更改为 `DELISTED`.
* `DELISTED` — 存档:该产品已缺货,将不再有交付。
如果产品退回仓库(例如,客户退回订单),则此状态将更改为 `INACTIVE`.
type: string
enum:
- ACTIVE
- INACTIVE
- DELISTED
- description: "通过市场上的类别ID进行过滤。\n\n要找出产品所属类别的ID,请使用请求 [POST\_v2/categories/tree](../../reference/categories/getCategoriesTree.md).\n\n您可以在一个参数中指定多个标识符(用逗号分隔),也可以在几个相同的参数中指定多个标识符。 例如:\n\n```text translate=no\n...category_id=14727164,14382343...\n...category_id=14727164&category_id=14382343...\n```\n\n在请求中,您可以指定参数 `shopSku`,或用于过滤产品的任何参数。 共享参数 `shopSku` 和过滤选项将导致错误。\n"
name: category_id
in: query
required: false
schema:
type: array
uniqueItems: true
items:
type: integer
- description: >
按产品品牌过滤。
您可以在一个参数中指定多个品牌,用逗号分隔,也可以在几个相同的参数中指定多个品牌。 例如:
```text translate=no
...vendor=Aqua%20Minerale,Borjomi...
...vendor=Aqua%20Minerale&vendor=Borjomi...
```
为了将产品包含在过滤结果中,其品牌必须与请求中指定的品牌之一完全匹配。 例如,如果指定了品牌
Schwarzkopf,那么结果中就没有产品了 Schwarzkopf
Professional.
如果品牌名称包含表中未包含的字符 ASCII (包括西里尔字符),用于它们
URL-编码。 例如,一个空间 — %20,撇号"'" —
%27等。 有关详细信息,请参阅 [编码 URL
俄语维基百科](https://ru.wikipedia.org/wiki/URL#Кодирование_URL).
在请求中,您可以指定shopSku参数或用于筛选产品的任何参数。 共享参数 `shopSku` 和过滤选项将导致错误。
name: vendor
in: query
required: false
schema:
type: array
uniqueItems: true
items:
type: string
- name: page_token
description: >
结果页面的ID。
如果省略该参数,则返回第一页。
我们建议传输输出参数的值 `nextPageToken`,在最后一次请求期间接收。
如果设置 `page_token` 并且请求有参数 `page` 和
`pageSize` 它们被忽略了。
in: query
required: false
example: eyBuZXh0SWQ6IDIzNDIgfQ==
schema:
type: string
- name: limit
description: |
每页的值数。
in: query
required: false
example: 20
schema:
type: integer
format: int32
minimum: 1
headers: []
body: null
schema: {}
method: get
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
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协会并注册产品。