delete

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

Узнайте больше

Ограничения

Не более 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).

Да

Ответ

Структура ответа в формате 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

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

Предыдущая
Следующая