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

# get

Возвращает расширения, отвечающие заданным критериям.

В настоящее время доступен один тип расширения — уточнение.

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

- [Как работает метод get](https://yandex.ru/dev/direct/doc/dg/best-practice/get.html)


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

Метод возвращает не более 10 000 объектов.


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

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

```javascript translate=no
{
  "method": "get",
    "params": { /* params */
    "SelectionCriteria": {  /* AdExtensionsSelectionCriteria */
      "Ids": [(long), ... ],
      "Types": [( "CALLOUT" ), ... ],
      "States": [( "ON" | "DELETED" ), ... ],
      "Statuses": [( "ACCEPTED" | "DRAFT" | "MODERATION" | "REJECTED" ), ... ],
      "ModifiedSince": (string)
    }, /* required */
    "FieldNames": [( "Id" | "Type" | "Status" | "StatusClarification" | "Associated" ), ... ], /* required */
    "CalloutFieldNames": [( "CalloutText" )],
    "Page": {  /* LimitOffset */
      "Limit": (long),
      "Offset": (long)
    }
  }
}
```


#|
||
**Параметр**
|
**Тип**
|
**Описание**
|
**Обязательный**
||
||
**Структура params (для JSON) / GetRequest (для SOAP)**
|
>
|
>
|
>
||
||
`SelectionCriteria`
|
AdExtensionsSelectionCriteria
|
Критерий отбора расширений.

Чтобы получить все расширения пользователя, необходимо указать пустой `SelectionCriteria`.
|
Да
||
||
`FieldNames`
|
array of AdExtensionFieldEnum
|
Имена параметров, общие для всех типов расширений, которые требуется получить.
|
Да
||
||
`CalloutFieldNames`
|
array of CalloutFieldEnum
|
Имена параметров расширения с типом «Уточнение», которые требуется получить.
|
Нет
||
||
`Page`
|
LimitOffset
|
Структура, задающая страницу при [постраничной выборке](https://yandex.ru/dev/direct/doc/dg/best-practice/get.html#page) данных.
|
Нет
||
||
**Структура AdExtensionsSelectionCriteria**
|
>
|
>
|
>
||
||
`Ids`
|
array of long
|
Отбирать расширения с указанными идентификаторами. Не более 10 000 элементов в массиве.
|
Нет
||
||
`Types`
|
array of AdExtensionTypeEnum
|
Отбирать расширения с указанными типами. В настоящее время доступен один тип расширения — «Уточнение» (CALLOUT).
|
Нет
||
||
`States`
|
array of AdExtensionStateSelectionEnum
|
Отбирать расширения с указанными состояниями. См. [Состояние расширения](https://yandex.ru/dev/direct/doc/dg/objects/adextension.html#state).

{% note info %}

Метод get возвращает расширение в состоянии DELETED, только если в параметре `States` указано значение DELETED или в параметре `Ids` указан идентификатор этого расширения. Если параметры `Ids` и `States` оба не заданы, метод не возвращает расширений в состоянии DELETED.

{% endnote %}
|
Нет
||
||
`Statuses`
|
array of ExtensionStatusSelectionEnum
|
Отбирать расширения с указанными статусами. См. [Статус расширения](https://yandex.ru/dev/direct/doc/dg/objects/adextension.html#status).
|
Нет
||
||
`ModifiedSince`
|
string
|
Отбирать расширения, в которых были изменения,начиная с указанной даты.

Задается в формате `YYYY-MM-DDThh:mm:ssZ` (согласно ISO 8601), например `2015-05-24T23:59:59Z`.
|
Нет
||
|# 


## Ответ {#output}

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

```javascript translate=no
{
  "result": { /* result */
    "AdExtensions": [{  /* AdExtensionGetItem */
      "Id": (long),
      "Associated": ( "YES" | "NO" ),
      "Type": ( "CALLOUT" | "UNKNOWN" ),
      "Callout": {  /* Callout */
        "CalloutText": (string) /* required */
      },
      "State": [( "ON" | "DELETED" | "UNKNOWN" ), ... ],
      "Status": ( "ACCEPTED" | "DRAFT" | "MODERATION" | "REJECTED" | "UNKNOWN" ),
      "StatusClarification": (string)
    }, ... ],
    "LimitedBy": (long)
  }
}
```


#|
||
**Параметр**
|
**Тип**
|
**Описание**
||
||
**Структура result (для JSON) / GetResponse (для SOAP)**
|
>
|
>
||
||
`AdExtensions`
|
array of AdExtensionGetItem
|
Расширения к объявлениям.
||
||
`LimitedBy`
|
long
|
Порядковый номер последнего возвращенного объекта. Передается в случае, если количество объектов в ответе было ограничено лимитом. См. раздел [Постраничная выборка](https://yandex.ru/dev/direct/doc/dg/best-practice/get.html#page).
||
||
**Структура AdExtensionGetItem**
|
>
|
>
||
||
`Id`
|
long
|
Идентификатор расширения.
||
||
`Associated`
|
YesNoEnum
|
Привязано ли расширение хотя бы к одному объявлению клиента.
||
||
`Type`
|
AdExtensionTypeEnum
|
Тип расширения.
||
||
`Callout`
|
Callout
|
Параметры расширения с типом «Уточнение».
||
||
`State`
|
StateEnum
|
Состояние расширения. См. [Состояние расширения](https://yandex.ru/dev/direct/doc/dg/objects/adextension.html#state).
||
||
`Status`
|
StatusEnum
|
Статус расширения. См. [Статус расширения](https://yandex.ru/dev/direct/doc/dg/objects/adextension.html#status).
||
||
`StatusClarification`
|
string
|
Текстовое пояснение к статусу и/или причины отклонения на модерации.
||
||
**Структура Callout**
||
||
`CalloutText`
|
string
|
Текст уточнения.
||
|#