UpdateClientInfo (Live)

Changes Yandex.Direct accounts.

Attention.

This method is outdated and will soon be disabled. Use version 5 of the API.

For information about the compatibility of methods between versions Live 4 and 5, see the Migration guide.

Direct advertisers and advertising agencies can change their own accounts and their delegates' accounts. Advertising agencies can also change their clients' accounts.

New in the Live 4 version

Added the DisplayStoreRating input parameter.

Input data

The input data structure in JSON is shown below.

{
   "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)
      }
      ...
   ]
}

Parameters are described below.

ParameterDescriptionRequired
ClientInfo object
Login

The Yandex username.

Yes
Phone

Contact phone number in any format. We recommend using international phone number format, for example: +7(495)137-33-33.

Yes
FIO

Last name and initials.

Yes
Email

The email address to send notifications and news to.

Yes
SendNews

Send Yandex.Direct news — Yes/No.

If client info can be edited (not agency)
SendAccNews

Send status notifications for campaigns that have a personal Yandex manager — Yes/No.

SendWarn

Send a notification when ads are moved to lower positions than desired — Yes/No.

ClientRights

Array of ClientRight objects. They define the rights of an advertising agency's client for managing campaigns that the agency created for this client.

This parameter is only available to advertising agencies. If omitted, all rights are revoked (set to No).

No
DisplayStoreRatingShow the store's rating in ads — Yes/No. If omitted, it will be set to Yes.No
ClientRight object
RightName

Name of the permission that is being granted or revoked:

  • AllowEditCampaigns — allow making changes to campaign parameters.
  • AllowTransferMoney — allow transferring funds between campaigns.
  • AllowImportXLS — allow downloading data from MS Excel files.
Yes
Value

Yes indicates granting the specified rights, and No indicates revoking them.

Yes

Output data

Returns 1 when data was changed successfully, as shown in the following example.

{
   "data": 1
}

Examples of input data

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'
   }
]