指定产品的建议投标

Info

Console

方法适用于所有模式.

目前不适用于卖家Market Yandex Go.

如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一

pricing — 价格管理
pricing:read-only — 查看价格
promotion — 商品推广
promotion:read-only — 查看商品推广信息
all-methods — 全面管理账户
all-methods:read-only — 查看所有数据

返回指定产品的推荐出价，这会为您的优惠提供一定比例的展示次数和额外的促销工具。

一个建议的出价或几个可能返回一个产品. 在第二种情况下，不同的出价旨在实现不同的展示百分比并获得额外的促销工具。

如果产品刚刚添加到目录中，但尚未上市销售，则不会对其进行推荐出价。

单个请求最多可包含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。要找到答案，请使用请求 :no-translate[GET v2/campaigns].

ℹ️ 什么是市场上的橱柜和商店？

Min value: 1

Body

application/json

{
    "skus": [
        "string"
    ]
}

Name

Description

skus*

Type: string[]

您需要获得费率建议的产品列表。
你的 SKU -系统中的产品ID。

使用规则 SKU:

对于每个产品 SKU 一定有一个。
已经设置 SKU 它不能被释放并重新用于另一个产品。每个产品都应该收到一个以前从未在目录中使用过的新标识符。

SKU 产品可以在市场上的卖方帐户中更改。阅读有关如何做到这一点。在市场对卖家的帮助.

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

Min items: 1

Max items: 1500

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: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

result

Type: GetBidsRecommendationsResponseDTO

推荐费率的产品列表。

ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Type	Description
ApiResponseStatusType	Enum: `OK`, `ERROR`

GetBidsRecommendationsResponseDTO

推荐费率的产品列表。

Name

Description

recommendations*

Type: SkuBidRecommendationItemDTO[]

推荐费率的产品列表。
推荐费率的产品列表。

SkuBidRecommendationItemDTO

推荐费率的产品列表。

Name	Description
bid*	Type: integer<int32> Значение рекомендованной ставки для товара из параметра `sku`, от 50 до 9999. Указывается в процентах от стоимости товара и умножается на 100. Например, ставка 5% обозначается как 500. В ответе присутствует не пустой `bidRecommendations` Не обращайте внимания на это поле. Example: `570` Min value: `0` Max value: `9999`
sku*	Type: string 你的 SKU -系统中的产品ID。使用规则 SKU: 对于每个产品 SKU 一定有一个。已经设置 SKU 它不能被释放并重新用于另一个产品。每个产品都应该收到一个以前从未在目录中使用过的新标识符。 SKU 产品可以在市场上的卖方帐户中更改。阅读有关如何做到这一点。在市场对卖家的帮助. 什么是 SKU 以及如何分配它 Min length: `1` Max length: `255` Pattern: `^(?=.\S.)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
bidRecommendations	Type: BidRecommendationItemDTO[] 与相应的印象份额和可用的附加促销工具的推荐出价的列表。出价越高，它有助于获得的印象份额就越大，额外的促销工具就越多。建议的出价、可能的展示百分比以及可用的其他推广工具。 Min items: `1`
priceRecommendations ⦸	Type: PriceRecommendationItemDTO[] 建议价格。的建议价格。 Min items: `1`

BidRecommendationItemDTO

建议的出价、可能的展示百分比以及可用的其他推广工具。

Name	Description
bid*	Type: integer<int32> Значение рекомендованной ставки для товара из параметра `sku`, от 50 до 9999. Указывается в процентах от стоимости товара и умножается на 100. Например, ставка 5% обозначается как 500. Example: `570` Min value: `0` Max value: `9999`
showPercent*	Type: integer<int64> 印象的百分比。 Min value: `0` Max value: `100`
benefits	Type: BenefitType[] 可用补贴清单。要获得必要的促销工具，请设置将为此工具或更高版本推荐的出价。额外推广工具的种类: `BESTS` -参与"市场畅销书"活动。 `SPLIT_0_0_4` -分期付款的可能性，为期4个月。 `SPLIT_0_0_6` -分期付款的可能性，为期6个月。 `SPLIT_0_0_12` -在12个月内分期付款的能力。 `MARKET_SUBSIDY_1_4` -从1到4％的市场折扣。 `MARKET_SUBSIDY_5_9` -从5到9％的市场折扣。 `MARKET_SUBSIDY_10` -从10％开始的市场折扣。 Enum: `BESTS`, `SPLIT_0_0_4`, `SPLIT_0_0_6`, `SPLIT_0_0_12`, `MARKET_SUBSIDY_1_4`, `MARKET_SUBSIDY_5_9`, `MARKET_SUBSIDY_10` Min items: `1` Unique items

PriceRecommendationItemDTO

的建议价格。

Name

Description

campaignId*

Type: integer<int64>

活动ID。

您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它-点击您的企业名称并转到页面:

模块和 API→区块 向Yandex发送数据。街市.
查询日志 →块中的下拉列表 显示日志.

，不要发送商店ID代替，这是在卖方的帐户在市场上的商店名称旁边和一些报告。

price*

Type: number

品的推荐价格。为了使促销效果良好，产品的价格不应高于此值。有关建议价格的更多信息

Min value: 1

BenefitType

额外推广工具的种类:

BESTS -参与"市场畅销书"活动。
SPLIT_0_0_4 -分期付款的可能性，为期4个月。
SPLIT_0_0_6 -分期付款的可能性，为期6个月。
SPLIT_0_0_12 -在12个月内分期付款的能力。
MARKET_SUBSIDY_1_4 -从1到4％的市场折扣。
MARKET_SUBSIDY_5_9 -从5到9％的市场折扣。
MARKET_SUBSIDY_10 -从10％开始的市场折扣。

Type	Description
BenefitType	Enum: `BESTS`, `SPLIT_0_0_4`, `SPLIT_0_0_6`, `SPLIT_0_0_12`, `MARKET_SUBSIDY_1_4`, `MARKET_SUBSIDY_5_9`, `MARKET_SUBSIDY_10`

400 Bad Request

请求包含不正确的数据。有关错误的更多信息

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

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: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

403 Forbidden

授权数据不正确或禁止访问资源。有关错误的更多信息

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

404 Not Found

找不到请求的资源。有关错误的更多信息

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

420 Method Failure

已超出资源访问限制。有关错误的更多信息

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

500 Internal Server Error

市场的内部错误。有关错误的更多信息

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。可能的值:

OK -没有错误。
ERROR -处理请求时发生错误。

Enum: OK, ERROR

这篇文章是否有用？

设定税率

商店质量指数