suspend

Останавливает показы объявления.

  1. Ограничения
  2. Запрос
  3. Ответ

Ограничения

Не более 10 000 объявлений в одном вызове метода.

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

Запрос

Структура запроса в формате JSON:

{
  "method": "suspend",
  "params": { /* params */
    "SelectionCriteria": {  /* IdsCriteria */
      "Ids": [(long), ... ] /* required */ 
    } /* required */
  } 
}
Параметр Тип Описание Обяза-тельный
Структура params (для JSON) / SuspendRequest (для SOAP)
SelectionCriteria IdsCriteria Критерий отбора объявлений, которые требуется остановить. Да
Структура IdsCriteria
Ids array of long Идентификаторы объявлений, которые требуется остановить (не более 10 000). Да
Параметр Тип Описание Обяза-тельный
Структура params (для JSON) / SuspendRequest (для SOAP)
SelectionCriteria IdsCriteria Критерий отбора объявлений, которые требуется остановить. Да
Структура IdsCriteria
Ids array of long Идентификаторы объявлений, которые требуется остановить (не более 10 000). Да

Ответ

Структура ответа в формате JSON:

{
  "result": { /* result */
    "SuspendResults": [{  /* ActionResult */
      "Id": (long),
      "Warnings": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
       }, ...
      ],
      "Errors": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
       }, ...
      ] 
    }, ... ] /* required */
  }
}
Параметр Тип Описание
Структура result (для JSON) / SuspendResponse (для SOAP)
SuspendResults array of ActionResult Результаты остановки объявлений.
Структура ActionResult
Id long Идентификатор объявления. Возвращается в случае отсутствия ошибок, см. раздел Операции над массивом объектов.
Warnings array of ExceptionNotification

Предупреждения, возникшие при выполнении операции.

Errors array of ExceptionNotification

Ошибки, возникшие при выполнении операции.

Параметр Тип Описание
Структура result (для JSON) / SuspendResponse (для SOAP)
SuspendResults array of ActionResult Результаты остановки объявлений.
Структура ActionResult
Id long Идентификатор объявления. Возвращается в случае отсутствия ошибок, см. раздел Операции над массивом объектов.
Warnings array of ExceptionNotification

Предупреждения, возникшие при выполнении операции.

Errors array of ExceptionNotification

Ошибки, возникшие при выполнении операции.