UpdateClientInfo (Live)

Изменяет учетные записи в Яндекс.Директе.

Внимание.

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

При вызове метода периодически выдается ошибка 59.

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

Прямые рекламодатели и рекламные агентства могут изменять собственные учетные записи и учетные записи своих представителей. Рекламные агентства также могут изменять учетные записи своих клиентов.

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

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

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

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

{
   "method": "UpdateClientInfo",
   "param": [
      {  /* ClientInfo */
         "Login": (string),
         "Phone": (string),
         "FIO": (string),
         "Email": (string),
         "ClientRights": [
            {  /* ClientRight */
               "RightName": (string),
               "Value": (string),
            }
            ...
         ],
         "SendNews": (string),
         "SendAccNews": (string),
         "SendWarn": (string),
         "DisplayStoreRating": (string)
      }
      ...
   ]
}

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

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

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

Да
Phone

Контактный телефон в произвольном формате. Рекомендуется указывать номер в международном формате, например +7(495)137-33-33.

Да
FIO

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

Да
Email

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

Да
SendNews

Сообщать о новостях Яндекс.Директа — Yes/No.

Если редактируются данные клиента (не агентства)
SendAccNews

Сообщать о состоянии кампаний, обслуживаемых персональным менеджером в Яндексе, — Yes/No.

SendWarn

Сообщать о перемещении объявлений на более низкие позиции относительно желаемых — Yes/No.

ClientRights

Массив объектов ClientRight. Они определяют полномочия клиента рекламного агентства по управлению кампаниями, которые агентство создало для него.

Параметр доступен только для рекламных агентств. Если не задан, все полномочия будут отменены (установлены в No).

Нет
DisplayStoreRating Показывать рейтинг магазина в объявлениях — Yes/No. Если не задан, будет установлен в Yes. Нет
Объект ClientRight
RightName

Название полномочий, которые предоставляются или отменяются:

  • AllowEditCampaigns — разрешать изменение параметров кампаний;
  • AllowTransferMoney — разрешать перевод средств между кампаниями;
  • AllowImportXLS — разрешать загрузку данных из файлов MS Excel.
Да
Value

Значение Yes — предоставить указанные полномочия, значение No — отменить.

Да

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

При успешном изменении данных возвращается значение 1, как показано в следующем примере.

{
   "data": 1
}

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

Python

[
   {
      'Login': 'agrom',
      'Phone': '+7(495)137-33-33',
      'FIO': 'Alex Gromov',
      'Email': 'gromov@yandex.ru',
      'ClientRights': [
         {
            'RightName': 'AllowEditCampaigns',
            'Value': 'Yes',
         }
      ],
      'SendNews': 'Yes',
      'SendAccNews': 'Yes',
      'SendWarn': 'Yes'
   }
]

PHP

array(
   array(
      'Login' => 'agrom',
      'Phone' => '+7(495)137-33-33',
      'FIO' => 'Alex Gromov',
      'Email' => 'gromov@yandex.ru',
      'ClientRights' => array(
         array(
            'RightName' => 'AllowEditCampaigns',
            'Value' => 'Yes',
         )
      ),
      'SendNews' => 'Yes',
      'SendAccNews' => 'Yes',
      'SendWarn' => 'Yes'
   )
)

Perl

[
   {
      'Login' => 'agrom',
      'Phone' => '+7(495)137-33-33',
      'FIO' => 'Alex Gromov',
      'Email' => 'gromov@yandex.ru',
      'ClientRights' => [
         {
            'RightName' => 'AllowEditCampaigns',
            'Value' => 'Yes',
         }
      ],
      'SendNews' => 'Yes',
      'SendAccNews' => 'Yes',
      'SendWarn' => 'Yes'
   }
]