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

# Агентствам

Агентству в Директе логически подчинены рекламодатели — клиенты этого агентства. Представители агентства могут управлять клиентами агентства и их рекламными кампаниями.  Агентство может использоваться в качестве управляющего аккаунта (MCC).

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

- [Клиент (Client)](https://yandex.com/dev/direct/doc/ru/objects/client.md)
- [Роли и доступы пользователей Директа](https://yandex.com/dev/direct/doc/ru/objects/roles.md)

## Управление рекламными кампаниями клиентов {#client-login}

Агентство может управлять данными (например, кампаниями или объявлениями) своих клиентов-рекламодателей, выполняя запросы к сервисам API Директа от имени представителя агентства. Для этого необходимо указать:

- в HTTP-заголовке `Authorization` — токен, полученный для представителя агентства;

- в HTTP-заголовке `Client-Login` — логин представителя клиента-рекламодателя.

Например:

```text translate=no
Authorization: Bearer 0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f0f
Client-Login: agrom
```

Таким образом, агентство может в одном запросе оперировать данными только одного рекламодателя. Если требуется получить или изменить данные нескольких рекламодателей, то необходимо выполнить отдельный запрос для каждого рекламодателя.

Исключения:

- В запросах к сервису [AgencyClients](https://yandex.ru/dev/direct/doc/ref-v5/agencyclients/agencyclients.html) HTTP-заголовок `Client-Login` указывать не следует.

- При вызове метода [Clients.get](https://yandex.ru/dev/direct/doc/ref-v5/clients/get.html). HTTP-заголовок `Client-Login` можно не указывать, либо указать логин представителя агентства, либо указать логин представителя рекламодателя.

- При вызове методов [Dictionaries.get](https://yandex.ru/dev/direct/doc/ref-v5/dictionaries/get.html), [Changes.checkDictionaries](https://yandex.ru/dev/direct/doc/ref-v5/changes/checkDictionaries.html), [KeywordsResearch.deduplicate](https://yandex.ru/dev/direct/doc/ref-v5/keywordsresearch/deduplicate.html) и [KeywordsResearch.hasSearchVolume](https://yandex.ru/dev/direct/doc/ref-v5/keywordsresearch/hasSearchVolume.html) HTTP-заголовок `Client-Login` указывать необязательно.

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

- [HTTP-заголовки](https://yandex.com/dev/direct/doc/ru/concepts/headers.md)
- [Авторизационные токены](https://yandex.com/dev/direct/doc/ru/concepts/auth-token.md)

## Управление клиентами {#agencyclients}

Запросы к сервису [AgencyClients](https://yandex.ru/dev/direct/doc/ref-v5/agencyclients/agencyclients.html) нужно выполнять от имени представителя агентства.

Представитель агентства может:

- Получать список рекламодателей — клиентов агентства, их параметры и настройки главных представителей рекламодателя c помощью метода [AgencyClients.get](https://yandex.ru/dev/direct/doc/ref-v5/agencyclients/get.html).

- Регистрировать новых рекламодателей — клиентов агентства c помощью метода [AgencyClients.addPassportOrganization](https://yandex.ru/dev/direct/doc/ref-v5/agencyclients/addPassportOrganization.html). Доступ к методу предоставляется [по заявке](https://yandex.ru/dev/direct/doc/support/troubleshooting/add-client.html) только тем агентствам, которые обслуживают большое количество активных клиентов и имеют потребность в регулярной массовой регистрации новых аккаунтов.

- Изменять параметры рекламодателей — клиентов агентства, а также настройки их главных представителей с помощью метода [AgencyClients.update](https://yandex.ru/dev/direct/doc/ref-v5/agencyclients/update.html).

## Получение параметров агентства и настроек представителя {#own}

С помощью метода [Clients.get](https://yandex.ru/dev/direct/doc/ref-v5/clients/get.html):

- Любой представитель агентства может получать параметры агентства и собственные настройки.

- Главный представитель агентства может, кроме собственных настроек, получать настройки другого представителя: для этого необходимо передать логин представителя в HTTP-заголовке запроса `Client-Login`.

## Баллы агентства {#points}

Владельцами баллов являются как рекламодатели, так и агентства. По умолчанию при выполнении запросов к API от имени представителя агентства расходуются баллы рекламодателя — клиента агентства (если указан HTTP-заголовок `Client-Login`). Чтобы расходовать баллы агентства, необходимо указать HTTP-заголовок

```text translate=no
Use-Operator-Units: true
```

Агентство самостоятельно принимает решение, в каких случаях расходовать собственные баллы, а в каких — баллы своего клиента. Например, собственные баллы позволяют агентству:

- создать рекламные кампании и объявления для нового клиента, у которого пока недостаточно собственных баллов;

- управлять кампаниями действующего клиента агентства, который исчерпал свой лимит баллов.

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

- [Ограничения, баллы](https://yandex.com/dev/direct/doc/ru/concepts/units.md)