Update
Изменяет настройки общих счетов.
Ограничения
Изменять настройки дневного бюджета можно не более 3 раз в сутки.
Входные данные
Ниже показана структура входных данных в формате JSON.
Внимание
Значения неуказанных параметров не изменяются.
{
"method": "AccountManagement",
"param": {
/* AccountManagementRequest */
"Action": (string),
"Accounts": [
{ /* Account */
"AccountID": (int),
"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)
}
}
...
]
}
}
Ниже приведено описание параметров.
Параметр |
Описание |
Требуется |
Объект AccountManagementRequest |
||
|
Выполняемая операция: Update. |
Да |
|
Массив объектов |
Нет |
Объект Account |
||
|
Идентификатор общего счета, настройки которого необходимо изменить. |
Да |
|
Объект |
Нет |
|
Объект Чтобы получать уведомления, необходимо подписаться на них (см. раздел справки Подпишитесь на SMS-уведомленияSubscribe to SMS notifications). Телефонный номер для отправки берется из персональных данных пользователя (см. раздел справки Номера телефоновMobile numbers). |
Нет |
|
Объект |
Нет |
Объект AccountDayBudgetInfo |
||
|
Дневной бюджет общего счета (в валюте общего счета). Минимальное допустимое значение можно получить с помощью метода Dictionaries.get API версии 5, указав в запросе имя справочника Значение 0 — сброс дневного бюджета. |
Да |
|
Режим показа объявлений:
См. подраздел Дневной бюджетDaily budget раздела “Общий счет”“Shared account” помощи Директа. Режим действует для всех кампаний, соответствующая настройка кампании игнорируется. |
Да |
Объект SmsNotificationInfo |
||
|
Сообщать о зачислении средств на общий счет — Yes/No. Предустановленное значение — No. |
Нет |
|
Сообщать об исчерпании средств на общем счете — Yes/No. Предустановленное значение — No. |
Нет |
|
Сообщать об остановке кампаний по достижении дневного ограничения на общий счет — Yes/No. Предустановленное значение — Yes. |
Нет |
|
Время, начиная с которого разрешено отправлять SMS о событиях, связанных с общим счетом. Указывается в формате HH:MM, минуты задают кратно 15 (0, 15, 30, 45). Например, “19:45”. |
Нет |
|
Время, до которого разрешено отправлять SMS о событиях, связанных с общим счетом. Указывается в формате HH:MM, минуты задают кратно 15 (0, 15, 30, 45). Например, “19:45”. |
Нет |
Объект EmailNotificationInfo |
||
|
Адрес электронной почты для отправки уведомлений, связанных с общим счетом. |
Нет |
|
Минимальный баланс, при уменьшении до которого отправляется уведомление. Задается в процентах от суммы последнего платежа. Предустановленное значение — 20. |
Нет |
|
Сообщать об остановке кампаний по достижении дневного ограничения на общий счет — Yes/No. Предустановленное значение — Yes. |
Нет |
Результирующие данные
Внимание
Ошибка при изменении настроек одного из общих счетов не влечет отмену всей операции и не влияет на успешность изменения настроек остальных общих счетов.
Ниже показана структура результирующих данных в формате JSON.
{
"data": {
/* AccountManagementResponse */
"ActionsResult": [
{ /* AccountActionResult */
"AccountID": (int),
"Errors": [
{ /* Error */
"FaultCode": (int),
"FaultString": (string),
"FaultDetail": (string)
}
...
]
}
...
]
}
}
Ниже приведено описание параметров.
Параметр |
Описание |
Объект AccountManagementResponse |
|
|
Массив объектов
Элементы массива следуют в том же порядке, что и объекты входного массива |
Объект AccountActionResult |
|
|
Идентификатор общего счета, настройки которого успешно изменены. |
|
Массив объектов |
Объект Error |
|
|
Код ошибки. |
|
Текст сообщения об ошибке. |
|
Подробное описание причины ошибки. |
Примеры входных данных
Python
{
'Action': 'Update',
'Accounts': [
{
'AccountID': 1327944,
'SmsNotification': {
'MoneyInSms': 'Yes',
'MoneyOutSms': 'Yes'
},
'EmailNotification': {
'Email': 'agrom@yandex.ru',
'MoneyWarningValue': 25
}
}
]
}
PHP
array(
'Action' => 'Update',
'Accounts' => array(
array(
'AccountID' => 1327944,
'SmsNotification' => array(
'MoneyInSms' => 'Yes',
'MoneyOutSms' ='Yes'
),
'EmailNotification' => array(
'Email' => 'agrom@yandex.ru',
'MoneyWarningValue' =25
)
)
)
)
Perl
{
'Action' => 'Update',
'Accounts' => [
{
'AccountID' => 1327944,
'SmsNotification' ={
'MoneyInSms' => 'Yes',
'MoneyOutSms' ='Yes'
},
'EmailNotification' ={
'Email' => 'agrom@yandex.ru',
'MoneyWarningValue' =25
}
}
]
}