---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.ru/dev/direct/doc/en/get.md
  - https://yandex.ru/dev/direct/doc/ru/get.md
  - href: ru/get.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/start/get.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt

# Урок 6. Как получать данные через API



В этом уроке мы расскажем о структуре API и рассмотрим несколько примеров получения данных.

Напомним схему взаимосвязи объектов в API Директа, которую мы показывали в первом уроке:

![](_assets/intro_objects_scheme.png)

Для каждого класса объектов в API предусмотрен соответствующий сервис: `Campaigns` — для управления кампаниями, `AdGroups` — для управления группами объявлений, `Ads` — для управления объявлениями и т. д. Полный список сервисов приведен в документации.

Логика работы с объектами в API унифицирована, и методы всех сервисов имеют стандартные названия. Как правило, сервис включает следующие методы:

- `add` — добавление объектов;
- `update` — изменение параметров объектов;
- `delete` — удаление объектов;
- `get` — получение объектов.

В сервисе могут быть и другие методы. Например, в сервисе `Campaigns` доступны следующие методы:

![](_assets/get_methods.png)

## Как получать объекты {#get_get_obj}

Давайте рассмотрим, как получить параметры кампании, используя метод `get`.

Метод `get` разработан так, чтобы можно было запрашивать только нужные данные. Например, можно получить только идентификаторы и названия кампаний, а не все их параметры. Имена нужных вам параметров необходимо перечислить во входном параметре `FieldNames`.

![](_assets/get_params.png)

Критерии отбора объектов нужно указать во входной структуре `SelectionCriteria`. Если критериев отбора несколько, то сервер будет искать объекты, подходящие сразу под все критерии. Некоторые сервисы позволяют указывать пустую структуру `SelectionCriteria` — в этом случае возвращаются все объекты.