指定产品的建议投标
方法适用于所有模式.
目前不适用于卖家Market Yandex Go.
如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一
返回指定产品的推荐出价，这会为您的优惠提供一定比例的展示次数和额外的促销工具。
一个建议的出价或几个可以返回一个单一的产品. 在第二种情况下，不同的出价旨在实现不同的展示百分比并获得额外的促销工具。
如果产品刚刚添加到目录中，但尚未上市销售，则不会对其进行推荐出价。
单个请求最多可包含1,500个产品。
| ⚙️ 限制: 每分钟1,000个请求 |
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/businesses/{businessId}/bids/recommendations
Path parameters
|
Name |
Description |
|
businessId* |
Type: integer<int64> 内阁ID。 要找到答案，请使用请求 GET v2/campaigns. Min value: |
Body
application/json
{
"skus": [
"string"
]
}
|
Name |
Description |
|
skus* |
Type: string[] 您需要获得费率建议的产品列表。
使用规则 SKU:
SKU 产品可以在市场上的卖方帐户中更改。 阅读有关如何做到这一点。 在市场对卖家的帮助. 重要 值开头和结尾的空格会自动删除。 例如, Min length: Max length: Pattern: Min items: Max items: Unique items |
Responses
200 OK
指定产品的推荐投标。
Body
application/json
{
"status": "OK",
"result": {
"recommendations": [
{
"sku": "string",
"bid": 570,
"bidRecommendations": [
{
"bid": 570,
"showPercent": 0,
"benefits": [
"BESTS"
]
}
],
"priceRecommendations": [
{
"campaignId": 0,
"price": 0
}
]
}
]
}
}
|
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.