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). | Да |
Параметр | Тип | Описание | Обяза-тельный |
Структура 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 | Ошибки, возникшие при выполнении операции. |