---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.2
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/live/AccountManagement_Get.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement_Get.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt

# Get
Возвращает параметры общих счетов.
## Входные данные

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

```javascript
{
   "method": "AccountManagement",
   "param": {
      /* AccountManagementRequest */
      "Action": (string),
      "SelectionCriteria": {
         /* AccountSelectionCriteria */
         "Logins": [
            (string)
            ...
         ],
         "AccountIDS": [
            (int)
            ...
         ]
      }
   }
}
```

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


#|
||
**Параметр**
|
**Описание**
|
**Требуется**
||

||
**Объект AccountManagementRequest**
||
||
`Action`
|
Выполняемая операция: Get.
|
Да
||
||
`SelectionCriteria`
|
Объект `AccountSelectionCriteria`, содержащий критерии отбора общих счетов.
|
Для агентств
||

||
**Объект AccountSelectionCriteria**
||
||
`Logins`
|
Для агентств — массив, содержащий логины рекламодателей (не более 50), чьи общие счета нужно получить.

Для рекламодателей допустимо указать единственный (свой) логин.
|
Для агентств — один из параметров `Logins` и `AccountIDS`
||
||
`AccountIDS`
|
Массив идентификаторов общих счетов (не более 100).
||

||
**Примечание**
||
||
1. Для рекламодателей оба параметра `Logins` и `AccountIDS` необязательны, но можно указать один из них. В случае пустой или отсутствующей структуры `SelectionCriteria` будут получены все общие счета (в редких случаях у рекламодателя может быть несколько общих счетов).
    
1. Для агентств должен быть задан один из параметров: либо `Logins`, либо `AccountIDS`.
||
|#

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

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

```javascript
{
   "data": {
      /* AccountManagementResponse */
      "Accounts": [
         {  /* Account */
            "AccountID": (int),
            "Amount": (float),
            "AmountAvailableForTransfer": (float),
            "Currency": (string),
            "Login": (string),
            "Discount": (float),
            "AgencyName": (string),
            "AccountDayBudget": {
               /* AccountDayBudgetInfo */
               "Amount": (float), 
               "SpendMode": (string)
            },
            "SmsNotification": {
               /* SmsNotificationInfo */
               "MoneyInSms": (string),
               "MoneyOutSms": (string),
               "PausedByDayBudgetSms": (string),
               "SmsTimeFrom": (string),
               "SmsTimeTo": (string)
            },
            "EmailNotification": {
               /* EmailNotificationInfo */
               "Email": (string),
               "MoneyWarningValue": (int),
               "PausedByDayBudget": (string)
            }
         }
         ...
      ],
      "ActionsResult": [
         {  /* AccountActionResult */
            
            "AccountID": (int),
            "Login": (string),
            "Errors": [
               {  /* Error */
                  "FaultCode": (int),
                  "FaultString": (string),
                  "FaultDetail": (string)
               }
               ...
            ]
         }
         ...
      ]
   }
}
```

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


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

||
**Объект AccountManagementResponse**
||
||
`Accounts`
|
Массив объектов `Account`. Каждый объект содержит параметры общего счета.
||
||
`ActionResult`
|
Массив объектов `AccountActionResult`. Содержит данные об ошибках, возникших при получении информации об общих счетах.
||

||
**Объект Account**
||
||
`AccountID`
|
Идентификатор общего счета.
||
||
`Amount`
|
Текущий баланс общего счета (в валюте общего счета, указанной в параметре `Currency`).
||
||
`AmountAvailableForTransfer`
|
Сумма, доступная для перевода с помощью операции [TransferMoney](https://yandex.com/dev/direct/doc/dg-v4/ru/live/AccountManagement_TransferMoney.md) (в валюте, указанной в параметре `Currency`).
||
||
`Currency`
|
Валюта общего счета.

Возможные значения: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN.
||
||
`Login`
|
Логин рекламодателя — владельца общего счета.
||
||
`Discount`
|
Текущая скидка рекламодателя (в процентах). В настоящее время не применяется.
||
||
`AgencyName`
|
Название рекламного агентства, обслуживающего счет. Для счетов, обслуживаемых рекламодателем самостоятельно, параметр отсутствует или равен NULL.
||
||
`AccountDayBudget`
|
Объект `AccountDayBudgetInfo` с параметрами дневного ограничения на общий счет.
||
||
`SmsNotification`
|
Объект `SmsNotificationInfo` с параметрами отправки SMS-уведомлений.

Чтобы получать уведомления, необходимо подписаться на них (см. раздел справки [Подпишитесь на SMS-уведомления](https://yandex.ru/support/direct/efficiency/sms-alerts.xml)[Subscribe to SMS notifications](https://yandex.com/support/direct/efficiency/sms-alerts.xml)). Телефонный номер для отправки берется из персональных данных пользователя (см. раздел справки [Номера телефонов](https://yandex.ru/support/passport/authorization/phone.xml)[Mobile numbers](https://yandex.com/support/passport/authorization/phone.xml)).
||
||
`EmailNotification`
|
Объект `EmailNotificationInfo` с параметрами отправки уведомлений по электронной почте.
||

||
**Объект AccountDayBudgetInfo**
||
||
`Amount`
|
Дневной бюджет общего счета (в валюте общего счета, указанной в параметре `Currency`).
||
||
`SpendMode`
|
Режим показа объявлений:

- Default — стандартный.
    
- Stretched — распределенный.
    

См. подраздел [Дневной бюджет](https://yandex.ru/support/direct/payments/shared-account.html#shared-account__day-budget)[Daily budget](https://yandex.com/support/direct/payments/shared-account.html#shared-account__day-budget) раздела “Общий счет”“Shared account” помощи Директа.

Режим действует для всех кампаний, соответствующая настройка кампании игнорируется.

{% note alert %}

Параметр устарел и больше не используется.

{% endnote %}
||

||
**Объект SmsNotificationInfo**
||
||
`MoneyInSms`
|
Сообщать об зачислении средств на общий счет — Yes/No.
||
||
`MoneyOutSms`
|
Сообщать об исчерпании средств на общем счете — Yes/No.
||
||
`PausedByDayBudgetSms`
|
Сообщать об остановке кампаний по достижении дневного ограничения на общий счет — Yes/No.
||
||
`SmsTimeFrom`
|
Время, начиная с которого разрешено отправлять SMS о событиях, связанных с общим счетом. Указывается в формате HH:MM, минуты задают кратно 15 (0, 15, 30, 45).
||
||
`SmsTimeTo`
|
Время, до которого разрешено отправлять SMS о событиях, связанных с общим счетом. Указывается в формате HH:MM, минуты задают кратно 15 (0, 15, 30, 45).
||

||
**Объект EmailNotificationInfo**
||
||
`Email`
|
Адрес электронной почты для отправки уведомлений, связанных с общим счетом.
||
||
`MoneyWarningValue`
|
Минимальный баланс, при уменьшении до которого отправляется уведомление. Задается в процентах от суммы последнего платежа. Предустановленное значение — 20.
||
||
`PausedByDayBudget`
|
Сообщать об остановке кампаний по достижении дневного ограничения на общий счет — Yes/No.
||

||
**Объект AccountActionResult**
||
||
`AccountID`
|
Идентификатор общего счета, для которого возникла ошибка (если был задан входной массив `AccountIDS`).
||
||
`Login`
|
Логин рекламодателя, для которого возникла ошибка (если был задан входной массив `Logins`).
||
||
`Errors`
|
Массив объектов `Error` — ошибок, возникших при получении информации.
||

||
**Объект Error**
||
||
`FaultCode`
|
Код ошибки.
||
||
`FaultString`
|
Текст сообщения об ошибке.
||
||
`FaultDetail`
|
Подробное описание причины ошибки.
||
|#

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

# Python

```python
{
   'Action': 'Get',
   'SelectionCriteria': {
      'AccountIDS': [1327944, 1327974]
   }
}
```

# PHP

```php
array(
   'Action' => 'Get',
   'SelectionCriteria' => array(
      'AccountIDS' => array(1327944, 1327974)
   )
)
```

# Perl

```perl
{
   'Action' => 'Get',
   'SelectionCriteria' ={
      'AccountIDS' => [1327944, 1327974]
   }
}
```