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

Идентификаторы объявлений, которые требуется удалить (не более ids-select).

Да

Ответ

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

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

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