有关设定费率的信息
方法适用于所有模式.
目前不适用于卖家Market Yandex Go.
如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一
返回指定产品的出价值。
您将无法获得有关在内阁中创建的活动的信息。
响应仅返回您通过请求设置的费率的值。 PUT v2/businesses/{businessId}/bids.
单个请求最多可包含1,500个产品。
**⚙️ 限制:**每分钟1,000个请求 |
---|
Request
POST
https://api.partner.market.yandex.ru/v2/businesses/{businessId}/bids/info
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
{
"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": {
"bids": [
{
"sku": "string",
"bid": 570
}
],
"paging": {
"nextPageToken": "string"
}
}
}
Name |
Description |
status* |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
result |
Type: GetBidsInfoResponseDTO 具有指定出价的产品列表。 |
ApiResponseStatusType
响应的类型。 可能的值:
OK
-没有错误。ERROR
-处理请求时发生错误。
Type |
Description |
Enum: |
GetBidsInfoResponseDTO
具有指定出价的产品列表。
Name |
Description |
bids* |
Type: SkuBidItemDTO[] 产品列表页。 |
paging |
Type: ForwardScrollingPagerDTO 下一页的ID。 |
SkuBidItemDTO
产品列表和对它们的投标。
Name |
Description |
bid* |
Type: integer<int32> Значение ставки для товара из параметра Указывается в процентах от стоимости товара и умножается на 100. Например, ставка 5% обозначается как 500. Example: Min value: Max value: |
sku* |
Type: string 你的 SKU -系统中的产品ID。 使用规则 SKU:
SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 在市场对卖家的帮助. Min length: Max length: Pattern: |
ForwardScrollingPagerDTO
下一页的ID。
Name |
Description |
nextPageToken |
Type: string 下一个结果页面的ID。 |
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.