获取股票列表

方法适用于所有模式.

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

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

返回有关市场促销的信息。 它不返回有关卖方创建的股票的数据。

默认情况下，卖方参与或可能参与的促销活动将被退回。

要获取当前或已完成的促销，请传递参数 participation.

响应中返回的共享类型:

  • 直接折扣;
  • flash推广;
  • 通过促销代码折扣.
⚙️ 限制: 每小时1,000个请求

Request

POST

https://api.partner.market.yandex.ru/v2/businesses/{businessId}/promos

Path parameters

Name

Description

businessId

Type: integer

内阁ID。 要找到答案，请使用请求 GET v2/campaigns.

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

Min value: 1

Body

application/json
{
  "participation": "PARTICIPATING_NOW",
  "mechanics": "DIRECT_DISCOUNT"
}

Name

Description

mechanics

Type: string

推广类别:

  • DIRECT_DISCOUNT — 直接折扣。

  • BLUE_FLASH — 一个闪光的促销。

  • MARKET_PROMOCODE — 通过促销代码折扣.

Enum: DIRECT_DISCOUNT, BLUE_FLASH, MARKET_PROMOCODE

participation

Type: string

在不指定过滤器的情况下，将返回卖家参与或可能参与的促销活动。

指定过滤器时将返回哪些共享:

  • PARTICIPATING_NOW — 卖方参与的当前促销活动。

  • PARTICIPATED — 完成了卖家在过去一年中参与的促销活动。 如果一年内少于15股，则响应将始终显示最后15股。

Enum: PARTICIPATING_NOW, PARTICIPATED

Responses

200 OK

的市场份额列表。

Body

application/json
{
  "status": "OK"
}

Type: object

400 Bad Request

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

Body

application/json
{
  "status": "OK"
}

Type: object

401 Unauthorized

请求中未指定授权数据。 有关错误的更多信息

Body

application/json
{
  "status": "OK"
}

Type: object

403 Forbidden

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

Body

application/json
{
  "status": "OK"
}

Type: object

404 Not Found

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

Body

application/json
{
  "status": "OK"
}

Type: object

420 Method Failure

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

Body

application/json
{
  "status": "OK"
}

Type: object

500 Internal Server Error

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

Body

application/json
{
  "status": "OK"
}

Type: object

No longer supported, please use an alternative and newer version.

上一篇
从检疫中删除在商店的价格
下一篇
推广产品一览表