按商店价格划分的隔离产品列表
方法适用于所有模式.
如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一
返回以指定商店中设置的价格处于隔离状态的产品列表。
检查每个隔离项目的价格。 如果没有错误并且价格正确,请通过请求进行确认。 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和模块:
⚠️ 不要把它与:
Min value: |
Query parameters
|
Name |
Description |
|
limit |
Type: integer 每页的值数。 Min value: |
|
page_token |
Type: string 结果页面的ID。 如果省略该参数,则返回第一页。 我们建议传输输出参数的值 如果设置 Example: |
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: Unique items: Example
|
|
categoryIds |
Type: integer[] | null 在市场上按类别过滤。 Min items: Unique items: Example
|
|
offerIds |
Type: string[] | null 需要信息的产品的Id。
Min items: Max items: Unique items: Example
|
|
tags |
Type: string[] | null 按标签过滤。 Min items: Unique items: Example
|
|
vendorNames |
Type: string[] | null 按品牌过滤。 Min items: 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: 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.