---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.ru/dev/direct/doc/en/adgroups/delete.md
  - https://yandex.ru/dev/direct/doc/ru/adgroups/delete.md
sourcePath: ru/ref-v5/adgroups/delete.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt

# delete

Удаляет группы объявлений.

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

- [Как работает метод delete](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html)
- [Как обрабатывать ошибки](https://yandex.ru/dev/direct/doc/dg/concepts/errors.html)


## Ограничения {#restrictions}

Не более 10 000 групп в одном вызове метода.

Удалить можно только пустую группу, не содержащую объявлений и условий показа (ключевых фраз, условий нацеливания на аудиторию, условий нацеливания для динамических объявлений).

Не допускается удаление группы из архивной кампании.


## Запрос {#input}

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

```javascript translate=no
{
  "method": "delete",
  "params": { /* params */
    "SelectionCriteria": {  /* IdsCriteria */
      "Ids": [(long), ... ] /* required */
    } /* required */
  }
}
```


#|
||
**Параметр**
|
**Тип**
|
**Описание**
|
**Обязательный**
||
||
**Структура params (для JSON) / DeleteRequest (для SOAP)**
|
>
|
>
|
>
||
||
`SelectionCriteria`
|
IdsCriteria
|
Критерий отбора групп, которые требуется удалить.
|
Да
||
||
**Структура IdsCriteria**
|
>
|
>
|
>
||
||
`Ids`
|
array of long
|
Идентификаторы групп, которые требуется удалить (не более 10 000).
|
Да
||
|# 


## Ответ {#output}

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

```javascript translate=no
{
  "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
|
Идентификатор удаленной группы. Возвращается в случае отсутствия ошибок, см. раздел [Операции над массивом объектов](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html).
||
||
`Warnings`
|
array of ExceptionNotification
|
Предупреждения, возникшие при выполнении операции.
||
||
`Errors`
|
array of ExceptionNotification
|
Ошибки, возникшие при выполнении операции.
||
|#