CreateNewSubclient (Live)

Регистрирует клиента рекламного агентства в Яндексе и создает учетную запись в Яндекс.Директе.

Внимание.

Метод устарел и скоро будет отключен. Используйте API версии 5.

Информацию о соответствии методов в версиях Live 4 и 5 см. в Руководстве по переходу.

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

Внимание.

С 10 октября 2016 г. рекламные агентства могут регистрировать только клиентов, работающих в реальной валюте. Возможность регистрации новых клиентов, работающих в у. е., отключена. В связи с этим логика работы метода изменена.

Если у агентства одна допустимая валюта, а параметр Currency не указан или указано значение cu, клиент создается в валюте агентства.

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

Ограничения

Можно зарегистрировать не более 100 клиентов в сутки.

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

Добавлен входной параметр Currency.

Входные данные

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

{
   "method": "CreateNewSubclient",
   "param": {
      /* CreateNewSubclientRequest */
      "Login": (string),
      "Name": (string),
      "Surname": (string),
      "Currency": (string)
   }
}

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

Параметр Описание Требуется
Объект CreateNewSubclientRequest
Login

Логин клиента для регистрации на Яндексе.

По указанному логину создается учетная запись на Яндексе, поэтому логин должен быть уникальным. В противном случае возвращается сообщение об ошибке 252.

Не рекомендуется использовать в логине точки (их следует заменять дефисами) и символы верхнего регистра.

Да
Name Имя клиента, не более 20 символов. Не допускаются символы &=<>. Да
Surname Фамилия клиента, не более 20 символов. Не допускаются символы &=<>. Да
Currency

Обозначение валюты, в которой ведутся расчеты с клиентом.

Допустимые валюты указаны в результирующем параметре ClientCurrencies метода GetClientInfo (Live).

Да

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

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

{
   "data": {
      /* CreateNewSubclientResponse */
      "Login": (string),
      "Password": (string),
      "FIO": (string),
      "Email": (string),
      "ClientID": (int)
   }
}

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

Параметр Описание
Объект CreateNewSubclientResponse
Login

Логин пользователя на Яндексе.

Password

Автоматически сгенерированный пароль.

По логину и паролю клиент может авторизоваться на Яндексе.

FIO

Фамилия и инициалы.

Email

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

ClientID Идентификатор клиента.

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

Python

{
   'Login': 'agrom',
   'Name': 'Александр',
   'Surname': 'Громов',
   'Currency': 'cu'
}

PHP

array(
   'Login' => 'agrom',
   'Name' => 'Александр',
   'Surname' => 'Громов',
   'Currency' => 'cu'
)

Perl

{
   'Login' => 'agrom',
   'Name' => 'Александр',
   'Surname' => 'Громов',
   'Currency' => 'cu'
}