目录中的产品列表

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和模块:

  • 运动ID;
  • 标签 查询日志 →块中的下拉列表 显示日志.

⚠️ 不要把它与:

  • 商店的标识符,显示在商家的个人帐户中。
  • 广告活动。

Min value: 1

Query parameters

Name

Description

availability

Type: string[]

按产品交付计划过滤:

  • ACTIVE — 会有送货的。
  • INACTIVE — 不会有交付:产品有库存,但您不再计划交付。
  • DELISTED — 存档:该产品已缺货,将不再有交付。

您可以在一个参数中指定多个值,用逗号分隔,也可以在几个相同的参数中指定多个值。 例如:

...availability=INACTIVE,DELISTED...
...availability=INACTIVE&availability=DELISTED...

在请求中,您可以指定参数 shopSku,或用于过滤产品的任何参数。 共享参数 shopSku 和过滤选项将导致错误。

Unique items: true

Example: ``

category_id

Type: integer[]

通过市场上的类别ID进行过滤。

要找出产品所属类别的ID,请使用请求 POST v2/categories/tree.

您可以在一个参数中指定多个标识符(用逗号分隔),也可以在几个相同的参数中指定多个标识符。 例如:

...category_id=14727164,14382343...
...category_id=14727164&category_id=14382343...

在请求中,您可以指定参数 shopSku,或用于过滤产品的任何参数。 共享参数 shopSku 和过滤选项将导致错误。

Unique items: true

Example: ``

limit

Type: integer

每页的值数。

Min value: 1

mapping_kind

Type: string

映射的类型。 映射类型:

  • ALL — 所有产品。
  • ACTIVE — 即卖产品。

Enum: ACTIVE, ALL

offer_id

Type: string[]

目录中的产品Id。

Unique items: true

Example: ``

page_token

Type: string

结果页面的ID。

如果省略该参数,则返回第一页。

我们建议传输输出参数的值 nextPageToken,在最后一次请求期间接收。

如果设置 page_token 并且请求有参数 pagepageSize 它们被忽略了。

Example: eyBuZXh0SWQ6IDIzNDIgfQ==

shop_sku

Type: string[]

目录中的产品Id。

使用参数 offer_id 而不是这个参数。

Unique items: true

Example: ``

status

Type: string[]

按产品发布状态过滤:

  • READY — 该产品已通过审核。
  • IN_WORK — 该产品正在进行适度。
  • NEED_CONTENT — 对于没有的产品 SKU 在市场上 marketSku 您需要自己找到一张卡或创建一张卡。
  • NEED_INFO — 由于产品描述中的错误或信息缺失,产品审核失败。
  • REJECTED — 该产品没有通过审核,因为市场不打算发布此类产品。
  • SUSPENDED — 该产品尚未通过审核,因为市场尚未放置此类产品。
  • OTHER — 由于另一个原因,该产品未能审核。

您可以在一个参数中指定多个状态(以逗号分隔),也可以在多个相同的参数中指定多个状态。 例如:

...status=READY,IN_WORK...
...status=READY&status=IN_WORK...

在请求中,您可以指定shopSku参数或用于筛选产品的任何参数。 同时使用shopSku参数和过滤参数将导致错误。

Unique items: true

Example: ``

vendor

Type: string[]

按产品品牌过滤。

您可以在一个参数中指定多个品牌,用逗号分隔,也可以在几个相同的参数中指定多个品牌。 例如:

...vendor=Aqua%20Minerale,Borjomi...
...vendor=Aqua%20Minerale&vendor=Borjomi...

为了将产品包含在过滤结果中,其品牌必须与请求中指定的品牌之一完全匹配。 例如,如果指定了品牌 Schwarzkopf,那么结果中就没有产品了 Schwarzkopf Professional.

如果品牌名称包含表中未包含的字符 ASCII (包括西里尔字符),用于它们 URL-编码。 例如,一个空间 — %20,撇号"'" — %27等。 有关详细信息,请参阅 编码 URL 俄语维基百科.

在请求中,您可以指定shopSku参数或用于筛选产品的任何参数。 共享参数 shopSku 和过滤选项将导致错误。

Unique items: true

Example: ``

Responses

200 OK

目录中有关产品的信息。

Body

application/json
{
  "status": "OK"
}

Type: object

400 Bad Request

请求包含不正确的数据。 有关错误的更多信息

Body

application/json
{
  "status": "OK"
}

Type: object

401 Unauthorized

请求中未指定授权数据。 有关错误的更多信息

Body

application/json
{
  "status": "OK"
}

Type: object

403 Forbidden

授权数据不正确或禁止访问资源。 有关错误的更多信息

Body

application/json
{
  "status": "OK"
}

Type: object

404 Not Found

找不到请求的资源。 有关错误的更多信息

Body

application/json
{
  "status": "OK"
}

Type: object

420 Method Failure

已超出资源访问限制。 有关错误的更多信息

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协会并注册产品。