按商店价格划分的隔离产品列表

方法适用于所有模式.

如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一
  • pricing — 价格管理
  • pricing:read-only — 查看价格
  • all-methods — 全面管理账户
  • all-methods:read-only — 查看所有数据

返回以指定商店中设置的价格处于隔离状态的产品列表。

检查每个隔离项目的价格。 如果没有错误并且价格正确,请通过请求进行确认。 POST v2/campaigns/{campaignId}/price-quarantine/confirm. 如果价格确实错误,请使用查询设置正确的价格。 POST v2/campaigns/{campaignId}/offer-prices/updates.

什么是检疫?

如果产品的价格变化太大或与市场价格相差太大,就会被隔离。 更详细

过滤器可以在请求中使用。

结果逐页返回。

⚙️ 限制: 每分钟10,000件物品

Request

POST

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/price-quarantine

Path parameters

Name

Description

campaignId

Type: integer

广告系列(商店)的ID — 通过API工作时,代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接,但仅用于自动交互。

您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:

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

⚠️ 不要把它与:

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

Min value: 1

Query parameters

Name

Description

limit

Type: integer

每页的值数。

Min value: 1

page_token

Type: string

结果页面的ID。

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

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

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

Example: eyBuZXh0SWQ6IDIzNDIgfQ==

Body

application/json
{
  "offerIds": [
    "example"
  ],
  "cardStatuses": [
    "HAS_CARD_CAN_NOT_UPDATE"
  ],
  "categoryIds": [
    0
  ],
  "vendorNames": [
    "example"
  ],
  "tags": [
    "example"
  ]
}

Name

Description

cardStatuses

Type: string[] | null

按卡状态过滤。

什么是产品卡?

Min items: 1

Unique items: true

Example
[
  "HAS_CARD_CAN_NOT_UPDATE"
]

categoryIds

Type: integer[] | null

在市场上按类别过滤。

Min items: 1

Unique items: true

Example
[
  0
]

offerIds

Type: string[] | null

需要信息的产品的Id。

⚠️ 不要在同一时间使用此字段作为基于卡片状态、类别、品牌或标签的过滤器。 如果要使用过滤器,请将字段留空。

Min items: 1

Max items: 500

Unique items: true

Example
[
  "example"
]

tags

Type: string[] | null

按标签过滤。

Min items: 1

Unique items: true

Example
[
  "example"
]

vendorNames

Type: string[] | null

按品牌过滤。

Min items: 1

Unique items: true

Example
[
  "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: 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: |-
  {
    "offerIds": [
      "example"
    ],
    "cardStatuses": [
      "HAS_CARD_CAN_NOT_UPDATE"
    ],
    "categoryIds": [
      0
    ],
    "vendorNames": [
      "example"
    ],
    "tags": [
      "example"
    ]
  }
schema:
  description: |
    产品过滤

    请求可以指定offerIds筛选器或任何其他产品筛选器。 与其他筛选器共享offerIds筛选器将导致错误。
  type: object
  properties:
    offerIds:
      description: |
        需要信息的产品的Id。
        <br><br>
        ⚠️ 不要在同一时间使用此字段作为基于卡片状态、类别、品牌或标签的过滤器。 如果要使用过滤器,请将字段留空。
      type: array
      minItems: 1
      maxItems: 500
      uniqueItems: true
      nullable: 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
    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
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}/price-quarantine
host: https://api.partner.market.yandex.ru

No longer supported, please use an alternative and newer version.