燕基科斯.市场对价格的建议
方法适用于所有模式.
目前不适用于卖家Market Yandex Go.
如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一
该方法返回几种类型的建议。
- 有吸引力的价格的门槛。
- 展柜中价格吸引力的评价。
这些建议告诉你为了吸引买家,你需要设定什么价格。
过滤器可以在请求中使用。 结果逐页返回。
**⚙️ 限制:**每分钟100个请求 |
---|
Request
POST
https://api.partner.market.yandex.ru/v2/businesses/{businessId}/offers/recommendations
Path parameters
Name |
Description |
businessId* |
Type: integer<int64> 内阁ID。 要找到答案,请使用请求 :no-translate[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"
],
"competitivenessFilter": "OPTIMAL"
}
Name |
Description |
competitivenessFilter |
Type: PriceCompetitivenessType Фильтр, выводящий товары, с привлекательными, умеренными и непривлекательными ценами. Enum: |
offerIds |
Type: string[] 需要信息的产品的Id。 ,不要与其他过滤器在同一时间使用此字段。 如果要使用过滤器,请将字段留空。 使用规则 SKU:
SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 在市场对卖家的帮助. Min length: Max length: Pattern: Min items: Unique items |
PriceCompetitivenessType
价格的吸引力:
OPTIMAL
-有吸引力。AVERAGE
-适度。LOW
"没有吸引力。"
Type |
Description |
Enum: |
Responses
200 OK
有推荐的产品列表。
Body
application/json
{
"status": "OK",
"result": {
"paging": {
"nextPageToken": "string",
"prevPageToken": "string"
},
"offerRecommendations": [
{
"offer": {
"offerId": "string",
"price": {
"value": 0,
"currencyId": "RUR"
},
"competitiveness": "OPTIMAL",
"shows": 0
},
"recommendation": {
"offerId": "string",
"competitivenessThresholds": {
"optimalPrice": {
"value": 0,
"currencyId": "RUR"
},
"averagePrice": {
"value": 0,
"currencyId": "RUR"
}
}
}
}
]
}
}
Name |
Description |
status* |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
result |
Type: OfferRecommendationsResultDTO 有推荐的产品列表。 |
ApiResponseStatusType
响应的类型。 可能的值:
OK
-没有错误。ERROR
-处理请求时发生错误。
Type |
Description |
Enum: |
OfferRecommendationsResultDTO
有推荐的产品列表。
Name |
Description |
offerRecommendations* |
Type: OfferRecommendationDTO[] 产品列表页。 |
paging |
Type: ScrollingPagerDTO 有关结果页的信息。 |
OfferRecommendationDTO
有关价格状态和建议的信息。
Name |
Description |
offer |
Type: OfferForRecommendationDTO Информация о состоянии цен. |
recommendation |
Type: OfferRecommendationInfoDTO Рекомендации. |
ScrollingPagerDTO
有关结果页的信息。
Name |
Description |
nextPageToken |
Type: string 下一个结果页面的ID。 |
prevPageToken |
Type: string 上一个结果页面的ID。 |
OfferForRecommendationDTO
品的价格状态的信息。
Name |
Description |
competitiveness |
Type: PriceCompetitivenessType Привлекательность цены на товар. Enum: |
offerId |
Type: string 你的 SKU -系统中的产品ID。 使用规则 SKU:
SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 在市场对卖家的帮助. Min length: Max length: Pattern: |
price |
Type: BasePriceDTO 品的价格。 |
shows |
Type: integer<int64> 最近7天的产品卡展示次数。 |
OfferRecommendationInfoDTO
关于产品价格的建议。
Name |
Description |
competitivenessThresholds |
Type: PriceCompetitivenessThresholdsDTO Максимальные значения цены, при которых она является привлекательной или умеренной. |
offerId |
Type: string 你的 SKU -系统中的产品ID。 使用规则 SKU:
SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 在市场对卖家的帮助. Min length: Max length: Pattern: |
BasePriceDTO
品的价格。
Name |
Description |
currencyId* |
Type: CurrencyType Валюта. Enum: |
value* |
Type: number 品的价格。 Min value (exclusive): |
PriceCompetitivenessThresholdsDTO
它具有吸引力或适中的最高价格值。
Name |
Description |
averagePrice |
Type: BasePriceDTO 品的价格。 |
optimalPrice |
Type: BasePriceDTO 品的价格。 |
CurrencyType
货币代码:
RUR
-俄罗斯卢布。UAH
-乌克兰格里夫纳。BYR
-白俄罗斯卢布。KZT
-哈萨克斯坦坚戈。UZS
-乌兹别克总和。
Type |
Description |
Enum: |
400 Bad Request
请求包含不正确的数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
ApiErrorDTO
一般错误格式。
Name |
Description |
code* |
Type: string 的错误代码。 |
message |
Type: string 错误的描述。 |
401 Unauthorized
请求中未指定授权数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
403 Forbidden
授权数据不正确或禁止访问资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
404 Not Found
找不到请求的资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
420 Method Failure
已超出资源访问限制。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
500 Internal Server Error
Yandex的内部错误。 市场。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] 错误列表。 Min items: |
status |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
No longer supported, please use an alternative and newer version.
Если у вас установлена такая цена или ниже, она считается привлекательной.