产品推广价格

Deprecated

Info

Console

方法适用于所有模式.

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

pricing — 价格管理
pricing:read-only — 查看价格
all-methods — 全面管理账户
all-methods:read-only — 查看所有数据

我应该使用哪种方法而不是过时的方法？

POST v2/reports/goods-prices/generate

该方法仅适用于某些商店

这种方法仅适用于那些以卢布为商品设定价格的商店。

返回您在市场上推广产品的价格。

需要获得价格的货物在体内传输 POST-请求。

促销的价格取决于其他商店为产品设定的价格。如果几家商店供应相同的产品，则价格较低的产品首先在市场上销售。当低价产品用完时，价格较高的产品将开始销售。

输出数据包含每个产品的几个价格，对应于不同类型的促销。

您可以使用请求为产品设置价格。 POST v2/campaigns/{campaignId}/offer-prices/updates 或者以其他方式：例如，在具有目录的文件中指定它们。您还可以使用策略自动设置市场上的建议价格或最低价格。

提供了有关自动价格管理的详细信息在市场对卖家的帮助.

⚙️ 限制：每小时100,000件产品

Request

POST

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/offer-prices/suggestions

Path parameters

Name

Description

campaignId*

Type: integer<int64>

活动ID。

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

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

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

Min value: 1

Body

application/json

{
    "offers": [
        {
            "offerId": "string",
            "marketSku": 0
        }
    ]
}

Name

Description

offers*

Type: SuggestOfferPriceDTO[]

的产品清单。
您需要获得促销价格的产品。

Max items: 1000

SuggestOfferPriceDTO

您需要获得促销价格的产品。

Name

Description

marketSku

Type: integer<int64>

市场上的产品卡的ID。

Min value: 1

offerId

Type: string

你的 SKU -系统中的产品ID。

使用规则 SKU:

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

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

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

Responses

200 OK

市场上促销的价格清单。

Body

application/json

{
    "status": "OK",
    "result": {
        "offers": [
            {
                "marketSku": 0,
                "offerId": "string",
                "priceSuggestion": [
                    {
                        "type": "BUYBOX",
                        "price": 0
                    }
                ]
            }
        ]
    }
}

Name

Description

status*

Type: ApiResponseStatusType

响应的类型。可能的值:

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

Enum: OK, ERROR

result

Type: SuggestPricesResultDTO

促销的价格请求的结果。

ApiResponseStatusType

响应的类型。可能的值:

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

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

SuggestPricesResultDTO

促销的价格请求的结果。

Name

Description

offers*

Type: PriceSuggestOfferDTO[]

促销价格的产品列表。
有促销价的商品。

PriceSuggestOfferDTO

有促销价的商品。

Name	Description
marketSku	Type: integer<int64> 市场上的产品卡的ID。 Min value: `1`
offerId	Type: string 你的 SKU -系统中的产品ID。使用规则 SKU: 对于每个产品 SKU 一定有一个。已经设置 SKU 它不能被释放并重新用于另一个产品。每个产品都应该收到一个以前从未在目录中使用过的新标识符。 SKU 产品可以在市场上的卖方帐户中更改。阅读如何做到这一点。在市场对卖家的帮助. 什么是 SKU 以及如何分配它 Min length: `1` Max length: `255` Pattern: `^(?=.\S.)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
priceSuggestion	Type: PriceSuggestDTO[] 促销价格。价格的类型。 Min items: `1`

PriceSuggestDTO

价格的类型。

Name

Description

price

Type: number

价格是卢布。

type

Type: PriceSuggestType

Тип цены.

Enum: BUYBOX, DEFAULT_OFFER, MIN_PRICE_MARKET

PriceSuggestType

价格类别:

BUYBOX -目前正在销售的产品的最低价格。此价格实时更新。如果你把价格调低，你的报价就会开始显示。如果对于参数中的此值 price 显示的价格与您的价格相同，这意味着您的产品已经在展示柜中展示。如果您以外的其他卖家以相同的价格出售此产品，他们的报价也将依次与您一起显示。
DEFAULT_OFFER -市场推荐的价格，吸引买家。它仅针对服务上的热门产品计算，每四小时更新一次。
MIN_PRICE_MARKET -市场上的最低价格。所有地区市场上所有产品报价中的最低价格，包括那些在展柜中不可见的产品。这个价格是实时更新的，并提供更多的印象在市场上比最低或建议的价格。

Type	Description
PriceSuggestType	Enum: `BUYBOX`, `DEFAULT_OFFER`, `MIN_PRICE_MARKET`

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

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

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

这篇文章是否有用？

价格表

货物数量转移.