addPassportOrganization
Создает бизнес-аккаунт организации.
Примечание
В запросе к сервису AgencyClients
:
- В HTTP-заголовке
Authorization
укажите токен, полученный для представителя агентства. - В HTTP-заголовке
Member-Authorization
укажите токен для логина, который должен быть добавлен в бизнес-аккаунт в качестве участника
Узнайте больше
Запрос
Структура запроса в формате JSON:
{
"method": "addPassportOrganization",
"params": {
"Name": (string),
"Currency": ("RUB"|"BYN"|"CHF"|"EUR"|"KZT"|"TRY"|"UAH"|"USD"),
"Grants": [{
"Privilege": ("EDIT_CAMPAIGNS"|"IMPORT_XLS"|"TRANSFER_MONEY"),
"Value": ("YES"|"NO")
}, ... ],
"Notification":
"Lang": ("RU"|"UK"|"EN"|"TR"),
"Email": (string),
"EmailSubscriptions": [{
"Option": ("RECEIVE_RECOMMENDATIONS"|"TRACK_MANAGED_CAMPAIGNS"|"TRACK_POSITION_CHANGES"),
"Value": ("YES"|"NO")
}, ... ],
"Settings": [{
"Option": ("CORRECT_TYPOS_AUTOMATICALLY"|"DISPLAY_STORE_RATING"),
"Value": ("YES"|"NO")
}, ... ],
"TinInfo": {
"TinType": ("PHYSICAL"|"FOREIGN_PHYSICAL"|"LEGAL"|"FOREIGN_LEGAL"|"INDIVIDUAL" ),
"Tin": (string)
}
}
}
Параметр |
Тип |
Описание |
Обязательный |
Структура params (для JSON) / AddPassportOrganization (для SOAP) |
|||
|
string |
Название паспортной организации, которая будет выступать в качестве главного представителя рекламодателя. В кабинете Директа будет отображаться автоматически сгенерированный логин паспортной организации. Для указанного названия в Яндекс ID создается новая паспортная организация, которая привязывается к бизнес-группе агентства. Подробнее про организации.
Подробнее про ролевую модель сотрудников паспортных организаций Название должно содержать не более 30 символов. Не допускаются символы |
Да |
|
CurrencyEnum |
Валюта рекламодателя. |
Да |
|
array of GrantItem |
Полномочия рекламодателя по управлению кампаниями. Если не заданы — полномочия отсутствуют. |
Нет |
|
NotificationAdd |
Настройки email-уведомлений для главного представителя рекламодателя. |
Да |
|
array of ClientSettingAddItem |
Настройки рекламодателя, допускаются только значения YES или NO. |
Нет |
|
TinInfoAdd |
Налоговые данные конечного рекламодателя. |
Да |
Структура GrantItem |
|||
|
PrivilegeEnum |
Название полномочия:
Если полномочие не указано, оно будет создано со значением NO. Для полномочия IMPORT_XLS можно указать значение YES только при условии, что для полномочия EDIT_CAMPAIGNS также указано значение YES, в противном случае возвращается ошибка. |
Да |
|
YesNoEnum |
Есть ли у рекламодателя данное полномочие. |
Да |
Структура NotificationAdd |
|||
|
LangEnum |
Язык уведомлений. |
Да |
|
string |
Адрес электронной почты для отправки уведомлений, связанных с аккаунтом. |
Да |
|
array of EmailSubscriptionItem |
Типы уведомлений, отправляемых по электронной почте. |
Да |
Структура EmailSubscriptionItem |
|||
|
EmailSubscriptionEnum |
Тип уведомления:
Если тип уведомления не указан, он будет создан со значением NO. |
Да |
|
YesNoEnum |
Отправлять ли уведомления данного типа. |
Да |
Структура ClientSettingAddItem |
|||
|
ClientSettingAddEnum |
Имя настройки:
Если настройка не указана, она будет создана со значением NO. |
Да |
|
YesNoEnum |
Значение настройки. |
Да |
Структура TinInfoAdd |
|||
|
TinTypeEnum |
Тип организации:
|
Да |
|
string |
Номер налогоплательщика либо его аналог в стране регистрации. |
Да |
Ответ
Структура ответа в формате JSON:
{
"result": {
"Login": (string),
"ClientId": (long),
"Warnings": [{
"Code": (int),
"Message": (string),
"Details": (string)
}, ... ],
"Errors": [{
"Code": (int),
"Message": (string),
"Details": (string)
}, ... ]
}
}
Параметр |
Тип |
Описание |
Структура result (для JSON) / AddResponse (для SOAP) |
||
|
string |
Логин пользователя Директа — главного представителя рекламодателя. Возвращается в случае отсутствия ошибок, см. раздел Операции над массивом объектов. |
|
long |
Идентификатор созданного рекламодателя. Возвращается в случае отсутствия ошибок. |
|
array of ExceptionNotification |
Предупреждения, возникшие при выполнении операции. |
|
array of ExceptionNotification |
Ошибки, возникшие при выполнении операции. |