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

# archive

Архивирует объявления.

### Узнайте больше {#see-also}

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


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

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

Если объявление было в показе, то архивировать его можно только при условии, что показ остановлен владельцем (состояние SUSPENDED), см. [Статус и состояние объявления](https://yandex.ru/dev/direct/doc/dg/objects/ad.html). Не допускается архивирование объявлений-черновиков и объявлений, принадлежащих архивной кампании.


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

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

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

#|
|| **Параметр** | **Тип** | **Описание** | **Обязательный** ||

|| **Структура params (для JSON) / ArchiveRequest (для SOAP)** | > | > | > ||

|| `SelectionCriteria` | IdsCriteria | Критерий отбора объявлений, которые требуется архивировать.  | Да ||

|| **Структура IdsCriteria** | > | > | > ||

|| `Ids` | array of long | Идентификаторы объявлений, которые требуется архивировать (не более 10 000).  | Да ||
|# 


## Ответ {#output}

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

```javascript translate=no
{
  "result": { /* result */
    "ArchiveResults": [{  /* 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) / ArchiveResponse (для SOAP)** | > | > ||

|| `ArchiveResults` | 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 | Ошибки, возникшие при выполнении операции.  ||
|#