---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://www.yandex.ru/dev/direct/doc/en/get.md
  - https://www.yandex.ru/dev/direct/doc/ru/get.md
  - href: https://www.yandex.ru/dev/direct/doc/ru/get.md
    type: text/markdown
    title: Markdown version
  - href: https://www.yandex.ru/dev/direct/doc/ru/llms.txt?revision=r21714029
    rel: describedby
sourcePath: ru/start/get.md
title: Как получать данные через API Директа — API Яндекс Директа
description: Как получать данные через API Директа — структура API, стандартные методы сервисов и получение объектов с помощью метода get.
---
> **Documentation Index:** Fetch the complete configuration index at https://www.yandex.ru/dev/direct/doc/ru/llms.txt?revision=r21714029


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



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

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

![](_assets/intro_objects_scheme.png){.border-yes}

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

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

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

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

![](_assets/get_methods.png){.border-yes}

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

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

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

![](_assets/get_params.png){.border-yes}

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