从促销中删除产品

Info

Console

方法适用于所有模式.

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

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

pricing — 价格管理
promotion — 商品推广
all-methods — 全面管理账户

从促销中删除产品。

这些变化在4-6小时内开始生效。

⚙️ 限制：每小时10,000次请求

Request

POST

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

Path parameters

Name

Description

businessId*

Type: integer<int64>

内阁ID。要找到答案，请使用请求 :no-translate[GET v2/campaigns].

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

Min value: 1

Body

application/json

{
    "promoId": "string",
    "deleteAllOffers": false,
    "offerIds": [
        "string"
    ]
}

Name	Description
promoId*	Type: string 促销的ID。
deleteAllOffers	Type: boolean 要从促销活动中删除所有产品并且不再参与其中，请通过值 `true` 并且不要传递参数。 `offerIds`.
offerIds	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: `500` Unique items

Responses

200 OK

从促销中删除产品的结果。

Body

application/json

{
    "status": "OK",
    "result": {
        "rejectedOffers": [
            {
                "offerId": "string",
                "reason": "OFFER_DOES_NOT_EXIST"
            }
        ]
    }
}

Name

Description

status*

Type: ApiResponseStatusType

响应的类型。可能的值:

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

Enum: OK, ERROR

result

Type: DeletePromoOffersResultDTO

从促销中删除产品的结果。

仅当在请求中传递参数时才返回。 offerIds.

ApiResponseStatusType

响应的类型。可能的值:

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

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

DeletePromoOffersResultDTO

从促销中删除产品的结果。

仅当在请求中传递参数时才返回。 offerIds.

Name

Description

rejectedOffers

Type: RejectedPromoOfferDeleteDTO[]

错误删除的产品。

只有在有这样的项目的情况下才退还。
有关产品的信息以及删除时出现的错误。

Min items: 1

RejectedPromoOfferDeleteDTO

有关产品的信息以及删除时出现的错误。

Name

Description

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}$

reason*

Type: RejectedPromoOfferDeleteReasonType

错误描述:

OFFER_DOES_NOT_EXIST -橱柜里没有这个产品 SKU.

Enum: OFFER_DOES_NOT_EXIST

RejectedPromoOfferDeleteReasonType

错误描述:

OFFER_DOES_NOT_EXIST -橱柜里没有这个产品 SKU.

Type	Description
RejectedPromoOfferDeleteReasonType	Enum: `OFFER_DOES_NOT_EXIST`

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

这篇文章是否有用？

在促销中添加产品/更改价格

关于一个订单