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).

 Да
Параметр Описание Требуется
Объект 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 Идентификатор клиента.
Параметр Описание
Объект 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'
}