ads.updateClients

Метод редактирует клиентов рекламного агентства. Доступен только для рекламных агентств.

Этот метод можно вызвать с ключом доступа пользователя.

Требуются права доступа: ads.

Параметры

account_id

string

Необязательный параметр. Идентификатор рекламного кабинета.

data

string

Обязательный параметр. Сериализованный JSON-массив объекта client_specification.

`client_specification`

Объект описывает клиента рекламного агентства.

Параметр	Тип	Описание
`name`	`string`	Название клиента. Длина строки: от 3 до 60 символов.
`day_limit`	`integer`	Дневной лимит в рублях.
`all_limit`	`integer`	Общий лимит в рублях. Значение `0` отключает лимит.
`ord_data`	`string`	Данные оператора рекламных данных в формате JSON (`ord_data_specification`). Доступно с версии 5.194.

`ord_data_specification`

Объект описывает оператора рекламных данных.

Параметр	Тип	Описание
`client_type`	`string`	Тип клиента. Возможные значения: • `person` — физическое лицо. • `individual` — индивидуальный предприниматель. • `legal` — юридическое лицо.
`client_name`	`string`	Полное имя клиента или название организации клиента.
`inn`	`string`	ИНН клиента. Длина строки: 10 или 12 символов.
`phone`	`string`	Телефон клиента. Длина строки: от 7 до 20 символов.
`subagent`	`object`	Данные о подрядчике в формате JSON (`ord_subagent`).
`contract_number`	`string`	Номер контракта.
`contract_date`	`string`	Дата контракта в формате `DD.MM.YYYY`.
`contract_type`	`string`	Тип контракта. Примеры: • `Договор оказания услуг`. • `Дополнительное соглашение`. • `Посреднический договор`.
`contract_object`	`string`	Предмет контракта. Вы можете скопировать информацию из текста договора — пункт «Предмет договора» — или кратко опишите суть договора (что должны сделать заказчик и исполнитель).
`with_vat`	`boolean`	Информация о том, подлежит ли НДС оплате в рамках этого контракта.

`ord_subagent`

Объект описывает подрядчика.

Параметр	Тип	Описание
`type`	`string`	Тип подрядчика. Возможные значения: • `person` — физическое лицо. • `individual` — индивидуальный предприниматель. • `legal` — юридическое лицо.
`name`	`string`	Название подрядчика.
`inn`	`string`	ИНН подрядчика. Длина строки: 10 или 12 символов.
`phone`	`string`	Телефон подрядчика. Длина строки: от 7 до 20 символов.

Результат

Метод возвращает объект со следующими параметрами:

Параметр	Тип	Описание
`account_id`	`string`	Идентификатор рекламного кабинета.
`data`	`string`	Сериализованный JSON-массив объекта `client_specification`.

Пример ответа:

JSON

{
  "account_id": 1900000000,
  "data": "[
    {
      'name': 'Клиент 1',
      'day_limit': 1000,
      'all_limit': 20000,
      'ord_data': {
        'client_type': 'individual', 
        'client_name': 'Персик Рыжий',
        'inn': '111111111111',
        'phone': '+79000000000',
        'contract_number': '№134',
        'contract_date': '22.09.2021',
        'contract_type': 'Договор оказания услуг',
        'contract_object': 'Услуга',
        'with_vat': true
      }
    }
  ]"
}

Коды ошибок

601

Permission denied. You have requested too many actions this day. Try later.

В ходе выполнения могут произойти общие ошибки.