update
Изменяет параметры рекламодателя и настройки пользователя — представителя рекламодателя.
Любой представитель рекламодателя может редактировать параметры рекламодателя и собственные настройки.
Главный представитель рекламодателя может также редактировать настройки другого представителя: для этого необходимо передать логин представителя в HTTP-заголовке запроса Client-Login
.
Узнайте больше
Запрос
Примечание
Параметры ClientInfo
, Notification
, Phone
относятся к пользователю — представителю рекламодателя:
- пользователю, от имени которого выполняется запрос, — если запрос выполняется от имени любого представителя рекламодателя и в запросе отсутствует HTTP-заголовок
Client-Login
; - пользователю, чей логин указан в HTTP-заголовке
Client-Login
, — если запрос выполняется от имени главного представителя рекламодателя и в запросе присутствует HTTP-заголовокClient-Login
.
Параметр Settings
относится к рекламодателю и не зависит от представителя.
Структура запроса в формате JSON:
{
"method": "update",
"params": { /* params */
"Clients": [{ /* ClientUpdateItem */
"ClientInfo": (string),
"Notification": { /* NotificationUpdate */
"Lang": ( "RU" | "UK" | "EN" | "TR" ),
"Email": (string),
"EmailSubscriptions": [{ /* EmailSubscriptionItem */
"Option": ( "RECEIVE_RECOMMENDATIONS" | "TRACK_MANAGED_CAMPAIGNS" | "TRACK_POSITION_CHANGES" ), /* required */
"Value": ( "YES" | "NO" ) /* required */
}, ... ]
},
"Phone": (string),
"Settings": [{ /* ClientSettingUpdateItem */
"Option": ( "CORRECT_TYPOS_AUTOMATICALLY" | "DISPLAY_STORE_RATING" ), /* required */
"Value": ( "YES" | "NO" ) /* required */
}, ... ],
"TinInfo" : { /* TinInfoUpdate */
"TinType" : ( "PHYSICAL" | "FOREIGN_PHYSICAL" | "LEGAL" | "FOREIGN_LEGAL" | "INDIVIDUAL" ),
"Tin" : (string) /* nillable */
}, /* nillable */
"ErirAttributes": { /* ErirAttributesUpdate */
"Organization": { /* OrganizationUpdate */
"Name": (string), /* nillable */
"EpayNumber": (string), /* nillable */
"RegNumber": (string), /* nillable */
"OksmNumber": (string), /* nillable */
"OkvedCode": (string) /* nillable */
}, /* nillable */
"Contract": { /* ContractUpdate */
"Number": (string), /* nillable */
"Date": (string), /* nillable */
"Type": ( "CONTRACT" | "INTERMEDIARY_CONTRACT" | "ADDITIONAL_AGREEMENT" ), /* nillable */
"ActionType": ( "COMMERCIAL" | "DISTRIBUTION" | "CONCLUDE" | "OTHER" ), /* nillable */
"SubjectType": ( "REPRESENTATION" | "MEDIATION" | "DISTRIBUTION" | "ORG_DISTRIBUTION" | "OTHER" ), /* nillable */
"Price": { /* PriceUpdate */
"Amount": (decimal), /* required */
"IncludingVat": ( "YES" | "NO" ) /* required */
}, /* nillable */
"IsAgencyPayment": ( "YES" | "NO" ) /* nillable */
}, /* nillable */
"Contragent": { /* ContragentUpdate */
"Name": (string), /* nillable */
"Phone": (string), /* nillable */
"EpayNumber": (string), /* nillable */
"RegNumber": (string), /* nillable */
"OksmNumber": (string), /* nillable */
"TinInfo": { /* TinInfoUpdate */
"TinType": ( "PHYSICAL" | "FOREIGN_PHYSICAL" | "LEGAL" | "FOREIGN_LEGAL" | "INDIVIDUAL" ),
"Tin": (string) /* nillable */
} /* nillable */
} /* nillable */
} /* nillable */
}] /* required */
}
}
Параметр |
Тип |
Описание |
Обязательный |
Структура params (для JSON) / UpdateRequest (для SOAP) |
|||
|
array of ClientUpdateItem |
Параметры рекламодателя и настройки пользователя, которые требуется изменить. |
Да |
Структура ClientUpdateItem |
|||
|
string |
ФИО пользователя Директа (до 255 символов). |
Нет |
|
NotificationUpdate |
Настройки SMS- и email-уведомлений пользователя Директа. |
Нет |
|
string |
Номер телефона пользователя Директа (до 255 символов). |
Нет |
|
array of ClientSettingUpdateItem |
Настройки рекламодателя, допускающие только значения YES или NO. |
Нет |
|
TinInfoUpdate |
Налоговые данные конечного рекламодателя. |
Нет |
|
ErirAttributesUpdate |
Дополнительные данные рекламодателя для маркировки рекламы. |
Нет |
Структура NotificationUpdate |
|||
|
LangEnum |
Язык уведомлений. |
Нет |
|
string |
Адрес электронной почты для отправки уведомлений, связанных с аккаунтом (до 255 символов). |
Нет |
|
array of EmailSubscriptionItem |
Типы уведомлений, отправляемых по электронной почте. |
Нет |
Структура EmailSubscriptionItem |
|||
|
EmailSubscriptionEnum |
Тип уведомления:
|
Да |
|
YesNoEnum |
Отправлять ли уведомления данного типа. |
Да |
Структура ClientSettingUpdateItem |
|||
|
ClientSettingUpdateEnum |
Имя настройки:
|
Да |
|
YesNoEnum |
Значение настройки. |
Да |
Структура TinInfoUpdate |
|||
|
TinTypeEnum |
Тип организации:
|
Нет |
|
string |
Номер налогоплательщика либо его аналог в стране регистрации. |
Нет |
Структура ErirAttributesUpdate |
|||
|
OrganizationUpdate |
Информация об организации конечного рекламодателя. |
Нет |
|
ContractUpdate |
Информация о договоре клиента-контрагента с конечным рекламодателем. |
Нет |
|
ContragentUpdate |
Информация о контрагенте конечного рекламодателя. |
Нет |
Структура OrganizationUpdate |
|||
|
string |
Наименование организации. |
Нет |
|
string |
Номер электронного средства платежа. |
Нет |
|
string |
Регистрационный номер либо его аналог. |
Нет |
|
string |
Код страны регистрации юрлица в соответствии с ОКСМ. |
Нет |
|
string |
Код вида деятельности по ОКВЭД. |
Нет |
Структура ContractUpdate |
|||
|
string |
Номер договора. |
Нет |
|
string |
Дата договора в формате YYYY-MM-DD. |
Нет |
|
ContractTypeEnum |
Тип договора:
|
Нет |
|
ContractActionTypeEnum |
Тип осуществляемых посредником-представителем действий:
|
Нет |
|
ContractSubjectTypeEnum |
Предмет договора:
|
Нет |
|
ContractPrice |
Цена договора. |
Нет |
|
YesNoEnum |
Признак того, что по договору платит агент. |
Нет |
Структура ContractPrice |
|||
|
decimal |
Стоимость договора. |
Да |
|
YesNoEnum |
Включен ли в стоимость НДС. |
Да |
Структура ContragentUpdate |
|||
|
string |
Наименование. |
Нет |
|
string |
Номер телефона. |
Нет |
|
string |
Номер электронного средства платежа. |
Нет |
|
string |
Регистрационный номер либо его аналог. |
Нет |
|
string |
Код страны регистрации юрлица в соответствии с ОКСМ. |
Нет |
|
TinInfoUpdate |
Налоговые данные контрагента. |
Нет |
Ответ
Структура ответа в формате JSON:
{
"result": { /* result */
"UpdateResults": [{ /* ClientsActionResult */
"ClientId": (long),
"Warnings": [{ /* ExceptionNotification */
"Code": (int), /* required */
"Message": (string), /* required */
"Details": (string)
}, ...
],
"Errors": [{ /* ExceptionNotification */
"Code": (int), /* required */
"Message": (string), /* required */
"Details": (string)
}, ...
]
}, ... ] /* required */
}
}
Параметр |
Тип |
Описание |
Структура result (для JSON) / UpdateResponse (для SOAP) |
||
|
array of ClientsActionResult |
Результат изменения параметров рекламодателя и настроек пользователя. |
Структура ClientsActionResult |
||
|
long |
Идентификатор рекламодателя. Возвращается в случае отсутствия ошибок, см. раздел Операции над массивом объектов. |
|
array of ExceptionNotification |
Предупреждения, возникшие при выполнении операции. |
|
array of ExceptionNotification |
Ошибки, возникшие при выполнении операции. |