柜内按价格划分的隔离产品一览表
方法适用于所有模式.
如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一
以机柜中所有商店设定的价格返回处于隔离状态的产品列表。
检查每个隔离项目的价格。 如果没有错误并且价格正确,请通过请求进行确认。 POST v2/businesses/{businessId}/price-quarantine/confirm. 如果价格确实错误,请使用查询设置正确的价格。 POST v2/businesses/{businessId}/offer-prices/updates.
什么是检疫?
如果一个产品的价格变化太大或与市场价格相差太大,就会被隔离。 更详细
过滤器可以在请求中使用。
结果逐页返回。
| ⚙️ 限制: 每分钟10,000个产品,每个请求不超过500个产品 |
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/businesses/{businessId}/price-quarantine
Path parameters
|
Name |
Description |
|
businessId* |
Type: integer<int64> 内阁ID。 要找到答案,请使用请求 GET v2/campaigns. Min value: |
Query parameters
|
Name |
Description |
|
limit |
Type: integer<int32> 每页的值数。
Min value: |
|
page_token |
Type: string 结果页面的ID。 如果省略该参数,则返回第一页。 我们建议传输输出参数的值 如果设置 |
Body
application/json
{
"offerIds": [
"string"
],
"cardStatuses": [
"HAS_CARD_CAN_NOT_UPDATE"
],
"categoryIds": [
0
],
"vendorNames": [
"string"
],
"tags": [
"string"
]
}
|
Name |
Description |
|
cardStatuses |
Type: string[] 按卡状态过滤。 什么是产品卡?
Enum: Min items: Unique items |
|
categoryIds |
Type: integer[] 在市场上按类别过滤。 Min value (exclusive): Min items: Unique items |
|
offerIds |
Type: string[] 需要信息的产品的Id。
使用规则 SKU:
SKU 产品可以在市场上的卖方帐户中更改。 阅读有关如何做到这一点。 在市场对卖家的帮助. Min length: Max length: Pattern: Min items: Max items: Unique items |
|
tags |
Type: string[] 按标签过滤。 Min items: Unique items |
|
vendorNames |
Type: string[] 按品牌过滤。 Min items: Unique items |
Responses
200 OK
检疫产品清单。
Body
application/json
{
"status": "OK",
"result": {
"paging": {
"nextPageToken": "string",
"prevPageToken": "string"
},
"offers": [
{
"offerId": "string",
"currentPrice": {
"value": 0,
"currencyId": "RUR"
},
"lastValidPrice": {
"value": 0,
"currencyId": "RUR"
},
"verdicts": [
{
"type": "PRICE_CHANGE",
"params": [
{
"name": "CURRENT_PRICE",
"value": "string"
}
]
}
]
}
]
}
}
|
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.