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

# GetClientInfo (Live)
Возвращает учетные записи в Яндекс Директе.



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

## Новое в версии Live 4

Добавлены результирующие параметры `OverdraftSumAvailable` и `Currency`.

Добавлены результирующие параметры `ClientCurrencies` и `VATRate` (см. также [раздел](https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/multicurrency.md)).

Добавлен результирующий параметр `SharedAccountEnabled`.

Добавлен результирующий параметр `DisplayStoreRating`.

Добавлен результирующий параметр `OverdraftSumAvailableInCurrency`.

Добавлен результирующий параметр `EnableVideoExtensionByDefault`.


## Входные данные {#input}

Ниже показана структура входных данных в формате JSON.

```javascript
{
   "method": "GetClientInfo",
   "param": [
      (string)
      ...
   ]
}
```

Массив `param` содержит логины учетных записей в Яндекс Директе (совпадают с логинами пользователей в Яндексе). Можно указать не более 1000 логинов.

При указании несуществующего логина возвращается сообщение об ошибке [259](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/ErrorCodes.md#ErrorCode259).

Вызов без `param` возвращает данные пользователя, от имени которого выполнен запрос.


## Результирующие данные {#output}

Ниже показана структура результирующих данных в формате JSON.

```javascript
{
   "data": [
      {  /* ClientInfo */
         "Login": (string),
         "DateCreate": (date),
         "Phone": (string),
         "FIO": (string),
         "Email": (string),
         "StatusArch": (string),
         "SharedAccountEnabled": (string),
         "Discount": (float),
         "OverdraftSumAvailable": (float),
         "OverdraftSumAvailableInCurrency": (float),
         "Currency": (string),
         "ClientCurrencies": [
            (string)
            ...
         ],
         "VATRate": (float),
         "SmsPhone": (string),
         "CampaignEmails": [
            (string)
            ...
         ],
         "ClientRights": [
            {  /* ClientRight */
               "RightName": (string),
               "Value": (string),
            }
            ...
         ],
         "Role": (string),
         "NonResident": (string),
         "SendNews": (string),
         "SendAccNews": (string),
         "SendWarn": (string),
         "DisplayStoreRating": (string), "EnableVideoExtensionByDefault": (string) 
     }
      ...
   ]
}
```

Ниже приведено описание параметров.


#|
||
**Параметр**
|
**Описание**
||

||
**Объект ClientInfo**
||
||
`Login`
|
Логин пользователя на Яндексе.
||
||
`Phone`
|
Контактный телефон в произвольном формате. Рекомендуется указывать номер в международном формате, например `+7(495)137-33-33`.
||
||
`DateCreate`
|
Дата регистрации пользователя, `YYYY-MM-DD`.
||
||
`FIO`
|
Фамилия и инициалы.
||
||
`Email`
|
Адрес электронной почты для отправки новостей и уведомлений.
||
||
`StatusArch`
|
Учетная запись пользователя помещена в архив (не активна) — Yes/No.
||
||
`SharedAccountEnabled`
|
Подключен ли у клиента общий счет — Yes/No.
||
||
`Discount`
|
Персональная скидка. В настоящее время не применяется.
||
||
`OverdraftSumAvailable`
|
Лимит овердрафта (у. е.), которым клиент может воспользоваться в текущий момент времени.

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

Оплата кампаний за счет овердрафта выполняется с помощью метода [PayCampaigns](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/PayCampaigns.md).
||
||
`OverdraftSumAvailableInCurrency`
|
Лимит овердрафта, которым клиент может воспользоваться в текущий момент времени, выраженный в валюте клиента.

Значение в реальной валюте не включает НДС.
||
||
`Currency`
|
Валюта, в которой выражен овердрафт. Параметр добавлен для будущего использования.
||
||
`ClientCurrencies`
|
Массив, содержащий обозначения валют клиента.

Если клиент является прямым рекламодателем или клиентом агентства (роль Client), то:

- если клиент работает в у. е., то параметр не возвращается (отсутствует или равен NULL);
- если клиент работает в реальной валюте, то массив содержит единственную валюту, в которой клиент может создавать новые кампании.

Если клиент является агентством (роль Agency), массив содержит доступные агентству валюты. Агентство может регистрировать субклиентов в этих валютах. Возможные значения: cu (условные единицы), RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN.
||
||
`VATRate`
|
Ставка НДС клиента, осуществляющего оплату: прямого рекламодателя или агентства. Если клиент является клиентом агентства, возвращается НДС агентства.
||
||
`SmsPhone`
|
Телефонный номер для отправки sms-уведомлений. Берется из учетной записи пользователя в Яндексе.
||
||
`CampaignEmails`
|
Массив адресов электронной почты всех кампаний пользователя.
||
||
`Role`
|
Роль в Яндекс Директе:

- Client — клиент рекламного агентства, или прямой рекламодатель, или представитель прямого рекламодателя;
- Agency — рекламное агентство или представитель агентства.
||
||
`NonResident`
|
Нерезидент — Yes/No.
||
||
`SendNews`
|
Сообщать о новостях Яндекс Директа — Yes/No.
||
||
`SendAccNews`
|
Сообщать о состоянии кампаний, обслуживаемых персональным менеджером в Яндексе, — Yes/No.
||
||
`SendWarn`
|
Сообщать о перемещении объявлений на более низкие позиции относительно желаемых — Yes/No.
||
||
`ClientRights`
|
Массив объектов `ClientRight`. Они определяют полномочия клиента рекламного агентства по управлению кампаниями, которые агентство создало для него.

Параметр доступен только для рекламных агентств.
||
||
`DisplayStoreRating`
|
Показывать [рейтинг магазина](https://yandex.ru/support/direct/features/market-rating.xml)[рейтинг магазина](https://yandex.com/support/direct/features/market-rating.xml) в объявлениях — Yes/No.
||
||
`EnableVideoExtensionByDefault`
|
По умолчанию добавлять видеодополнения к новым текстово-графическим объявлениям — Yes/No.
||

||
**Объект ClientRight**
||
||
`RightName`
|
Название полномочий, которые предоставляются или отменяются:

- AllowEditCampaigns — разрешать изменение параметров кампаний;
- AllowTransferMoney — разрешать перевод средств между кампаниями;
- AllowImportXLS — разрешать загрузку данных из файлов MS Excel.
||
||
`Value`
|
Значение Yes — предоставить указанные полномочия, значение No — отменить.
||
|#


## Примеры входных данных {#examples}

## Perl

```python
['agrom','larry']
```

## PHP

```php
array('agrom','larry')
```