Возобновление показа предложений

Описание

DELETE /campaigns/{campaignId}/hidden-offers

Возобновляет показ скрытых предложений магазина на Яндекс.Маркете. В теле запроса можно передать от одного до 500 предложений.

URL ресурса:

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/hidden-offers.[format]

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

Параметр

Тип

Значение

Обязательные

campaignId

Int64

Идентификатор магазина.

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

<hidden-offers>
  <hidden-offer feed-id="{int64}" offer-id="{string}"/>
  ...
</hidden-offers>

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

Параметр для формата XML

Параметр для формата JSON

Тип

Значение

hidden-offers hiddenOffers

Список скрытых предложений.

В теле запроса можно передать от одного до 500 предложений.

Обязательный параметр.

Параметры, вложенные в hidden-offers

hidden-offer

Скрытое предложение.

Обязательный параметр, указывается только для формата XML.

Параметры, вложенные в hidden-offer / hiddenOffers

feed-id feedId Int64

Идентификатор прайс-листа.

Обязательный параметр.

Для формата XML является атрибутом параметра hidden-offer.

offer-id offerId

String

Идентификатор предложения из прайс-листа.

Максимальная длина — 50 символов.

Обязательный параметр.

Для формата XML является атрибутом параметра hidden-offer.

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

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

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

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

Параметр для формата XML

Параметр для формата JSON

Тип

Значение

response

Ответ.

Параметр выводится только для формата XML.

Параметры, вложенные в response

errors errors

Список ошибок при выполнении запроса.

Выводится, если status="ERROR".

status status Enum

Статус выполнения запроса.

Возможные значения:

  • OK — запрос выполнен успешно.

  • ERROR — произошла ошибка.

Параметры, вложенные в errors

error

Информация об ошибке.

Параметр выводится только для формата XML.

Параметры, вложенные в error / errors

code code Enum

Код ошибки.

Возможные значения:

  • DUPLICATE_OFFER — в запросе переданы два или более товаров с одинаковыми значениями параметров feed-id и offer-id.

  • INVALID_FEED_ID — в теле запроса в параметре feed-id передан идентификатор прайс-листа, который не существует или не относится к магазину campaignId.

  • INVALID_OFFER_ID — в теле запроса в параметре offer-id передан пустой идентификатор предложения или его значение превышает 50 символов.

  • REQUEST_LIMIT_EXCEEDED — в теле запроса передано больше 500 предложений.

Для формата XML является атрибутом параметра error.

message message String

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

Для формата XML является атрибутом параметра error.

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

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

Ограничения

В одном запросе можно возобновить показы не более чем 500 предложений.

В течение минуты можно возобновить показы определенного количества предложений. Если у магазина:

  • не более 200 000 предложений — 1000 предложений;
  • более 200 000 предложений — ограничение определяется по формуле:
    (количество предложений магазина) / 200
Примечание.

Количество предложений магазина считается по данным за последние семь дней (не включая сегодня).

Примеры

Пример запроса:

curl -i -H 'Content-Type: application/xml' -X DELETE 'https://api.partner.market.yandex.ru/v2/campaigns/12345/hidden-offers.xml'

Тело DELETE-запроса:

-d '<hidden-offers>
  <hidden-offer feed-id="67891" offer-id="101Ab12313C"/>
</hidden-offers>'

Пример ответа:

HTTP/1.1 200 OK
Date: Fri, 11 Aug 2017 00:42:42 GMT
Content-Type: application/xml;charset=utf-8
...

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