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

# Клиент (Client)

Объект Клиент (Client) соответствует рекламодателю или рекламному агентству.

Рекламодатели подразделяются на прямых рекламодателей и клиентов агентств.

Рекламодателю принадлежат его рекламные кампании.

Агентству логически подчинены рекламодатели — клиенты этого агентства.

![client-types](../_images/client-types.png)

Кампаниями рекламодателя управляют пользователи Директа в зависимости от назначенной роли.


## Пользователи Директа и их роли {#user}

Пользователь, имеющий логин на Яндексе, становится пользователем Директа (у него появляется учетная запись в Директе), когда он становится **представителем** рекламодателя или агентства, то есть получает одну из следующих ролей:

- главный представитель рекламодателя;

- представитель рекламодателя;

- главный представитель агентства;

- представитель агентства;

- представитель агентства по работе с клиентами.


Например:

- Пользователь создает аккаунт в Директе, выбрав страну и валюту. В результате создается клиент — прямой рекламодатель, а пользователь становится главным представителем этого рекламодателя.

- Представитель агентства регистрирует в Директе логин для нового клиента. В результате создается рекламодатель — клиент агентства, а пользователь с указанным логином становится главным представителем этого рекламодателя.

- Другой пользователь назначает пользователя представителем рекламодателя или агентства.


Если пользователь Яндекса не является пользователем Директа, для него можно получить OAuth-токен, однако запросы к API Директа от его имени будут завершаться ошибкой.


{% note alert %}

Идентификатором пользователя является его логин на Яндексе. Если упоминается логин рекламодателя или агентства — имеется в виду логин его главного представителя. Идентификатором рекламодателя является `ClientId`.

{% endnote %}


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

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


## Методы {#service}

### Для рекламодателей {#service-advertisers}

Для управления параметрами рекламодателя и настройками пользователя — представителя рекламодателя предназначен сервис [Clients](https://yandex.ru/dev/direct/doc/ref-v5/clients/clients.html).

Методы: [update](https://yandex.ru/dev/direct/doc/ref-v5/clients/update.html) | [get](https://yandex.ru/dev/direct/doc/ref-v5/clients/get.html)

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

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

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

Методы: [addPassportOrganization](https://yandex.ru/dev/direct/doc/ref-v5/agencyclients/addPassportOrganization.html) | [update](https://yandex.ru/dev/direct/doc/ref-v5/agencyclients/update.html) | [get](https://yandex.ru/dev/direct/doc/ref-v5/agencyclients/get.html)

Для получения параметров агентства и настроек пользователя — представителя агентства предназначен метод [Clients](https://yandex.ru/dev/direct/doc/ref-v5/clients/clients.html).[get](https://yandex.ru/dev/direct/doc/ref-v5/clients/get.html).

Подробнее см. в разделе [Агентствам](https://yandex.ru/dev/direct/doc/ru/best-practice/agency.md).