delete

Удаляет объявления.

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

Ограничения

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

Не допускается удаление объявлений в следующих случаях:

  • Объявление было в показе и по нему накоплена статистика.
  • Объявление имеет статус отличный от DRAFT, при этом в кампании есть хотя бы одно объявление, для которого в данный момент идет активизация или остановка.
  • Объявление принято модерацией или отклонено после предварительного принятия, при этом на кампании/общем счете есть или были средства.

Для таких объявлений доступна архивация с помощью метода archive.

Запрос

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

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

Ответ

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

{
  "result": {  /* result */
    "DeleteResults": [{  /* 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) / DeleteResponse (для SOAP)
DeleteResults array of ActionResult Результаты удаления объявлений.
Структура ActionResult
Id long Идентификатор удаленного объявления. Возвращается в случае отсутствия ошибок, см. раздел Операции над массивом объектов.
Warnings array of ExceptionNotification

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

Errors array of ExceptionNotification

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

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

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

Errors array of ExceptionNotification

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