Удаление всех цен, установленных через API

Описание

POST /campaigns/{campaignId}/offer-prices/removals

Запрос удаляет все цены на предложения, установленные через API. После удаления начнут действовать цены из прайс-листов.

URL ресурса:

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/offer-prices/removals.[format]

Входные данные

Параметр	Тип	Значение
Обязательные
campaignId	Int64	Идентификатор кампании. Чтобы узнать идентификатор, войдите в личный кабинет магазина, нажмите на его название и скопируйте из поля Кампания № число после дефиса. Например, если указано значение «11-213856», то идентификатор кампании — 213856.

Параметр	Тип	Значение
Обязательные
campaignId	Int64	Идентификатор кампании. Чтобы узнать идентификатор, войдите в личный кабинет магазина, нажмите на его название и скопируйте из поля Кампания № число после дефиса. Например, если указано значение «11-213856», то идентификатор кампании — 213856.

Структура тела POST-запроса:

<offer-price-removal remove-all="true"/>

{
  "removeAll": true
}

Параметры тела POST-запроса:

Выходные данные

Структура выходных данных приведена ниже. Порядок следования параметров не гарантируется.

<response>
  <errors>
    <error code="{enum}" message="{string}"/>
    ...
  </errors>
  <status>{enum}</status>
</response>

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

Описание параметров:

Описание ошибок

В случае ошибки сервер возвращает HTTP-код ответа и краткое описание ошибки.

Ограничения

Если в течение последней минуты с помощью данного запроса уже были удалены все цены, при повторном выполнении запроса проверяется, у скольких предложений удалились цены в прошлый раз . Если превышено ограничение, запрос не выполнится, и сервер сообщит об ошибке. Ограничение зависит от количества предложений магазина:

• для небольших магазинов (не более 10 000 предложений) — 50 предложений;

• для остальных магазинов это ограничение определяется по формуле:

  (количество предложений магазина) / 200

Общее количество предложений магазина считается по данным за последние семь дней, не включая текущий день.

Примеры

curl -i -H 'Content-Type: application/xml' -X POST 'https://api.partner.market.yandex.ru/v2/campaigns/10001/offer-prices/removals.xml'

-d '<offer-price-removal remove-all="true"/>'

HTTP/1.1 200 OK
Date: Sat, 12 Apr 2018 08:37:40 GMT
Content-Type: application/xml;charset=utf-8
...

<response>
  <status>OK</status>
</response>

curl -i -H 'Content-Type: application/json' -X POST 'https://api.partner.market.yandex.ru/v2/campaigns/10001/offer-prices/removals.json'

-d '{
  "removeAll": true
}'

HTTP/1.1 200 OK
Date: Sat, 12 Apr 2018 08:37:40 GMT
Content-Type: application/json;charset=utf-8
...

{
  "status": "OK"
}