UpdateClientInfo

Changes Yandex Direct accounts.

Alert

Disabled method. Use version 5 of the API.

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

There is a version for the method UpdateClientInfo (Live).

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

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

Parameters are described below.

Parameter

Description

Required

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

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