Errors and warnings
This section lists codes and descriptions of errors and warnings in response messages from the Yandex Direct API version 5.
Errors
Error code | Message | Comments and possible reasons |
Server errors | ||
---|---|---|
52 | Authorization server temporarily unavailable | The Yandex Direct API server is temporarily unable to get information from the Yandex OAuth service. Try calling the method again later. |
1000 | Server temporarily unavailable | Internal error on the Yandex Direct API server. Try calling the method again later. If the error persists, contact the support service. |
1001 | Service initialization error | |
1002 | Operation error | |
1003 | Couldn't create a Yandex user account | An error occurred when creating the account. Try calling the method again later. |
1004 | Couldn't create client | An error occurred when creating a client in Yandex Direct. Try calling the method again later. Use a different username to repeat the request. |
1020 | Internal server error | The list of available currencies isn't defined. Contact support. |
Authentication error | ||
53 | Authorization error | Invalid OAuth token. For the reasons why a token may become invalid, see Revoking tokens in the Yandex OAuth guide. |
Incomplete app registration | ||
58 | Incomplete registration | You must submit a request for API access and wait for it to be approved. |
Permission errors | ||
54 | No rights |
|
513 | Your username is not enabled in Yandex Direct | The request is on behalf of a user who doesn't have a Yandex Direct account. To register an account, create an advertising campaign in this user's name in the web interface. See also Access and authorization. |
3000 | No API access |
|
3001 | No access to the method | Access to the AgencyClients.add method is granted to the agency on request. |
Restrictions, points | ||
152 | Not enough Yandex units | |
506 | Exceeded limit on number of connections | You have reached the maximum number of simultaneous connections to the Yandex Direct server. |
Unsupported fields, objects, and operations | ||
3500 | Not supported | Attempt to add bid adjustment is not compatible with the campaign type. |
3600 | Limited functionality | Attempt to use the PAY_FOR_CONVERSION or PAY_FOR_CONVERSION_PER_CAMPAIGN strategy. |
Invalid request parameters | ||
4000 | Invalid request parameters |
|
4001 | Invalid SelectionCriteria filter parameters |
|
4002 | Invalid page settings | Invalid value for the Limit or Offset parameter. |
4003 | All required parameters were omitted | The request must contain at least one parameter from the set, but none of them were specified. |
4004 | More than one parameter was passed | Mutually exclusive parameters were specified. Only one of them can be present in the request. |
4005 | A single type of Id must be used within a request | Bids are set with IDs of heterogeneous objects (for example, one Bids structure has CampaignId, but the other structure has AdGroupId). |
4006 | Incompatible operations are entered in the same request | To edit ad callouts, either use the ADD and REMOVE operations, or use the SET operation. |
Invalid field value | ||
5000 | Required field | A required field is empty, or the value consists of spaces. |
5001 | Exceeded allowed length |
|
5002 | Forbidden symbols used |
|
5003 | Empty value specified | There is an empty string, for example, in the Href parameter in an ad. |
5004 | Invalid format | Incorrect value for an object field, such as:
|
5005 | Field set incorrectly | Incorrect value for an object field, such as:
|
5006 | Invalid use of field |
|
5007 | Duplicated element | Sitelink texts are duplicates, or they link to the same webpage. |
5008 | All required fields were omitted | The object must have at least one field specified from the set, but none of them are specified. |
5009 | More than one field was passed | The object has mutually exclusive fields specified. |
5010 | Invalid field length | The field is too short. |
5100 | Incorrect template use | Incorrect use of templates (##) in the ad title and text. |
5120 | Geotargeting set incorrectly |
|
5140 | Keyword contains too many words | Exceeded the number of words in a keyword. |
5141 | Incorrect use of stop words | A keyword consists exclusively of stop words. |
5142 | Exceeded the maximum word length in a keyword | |
5160 | Negative keyword can't be a phrase | Attempt to use a negative keyword with a space in it. |
5161 | Incorrect use of negative keywords |
|
5162 | Exceed the maximum length of a negative keyword | |
5181 | You cannot change the advertised application | |
5200 | Login already in use | Attempt to create a client with a login name that is already used by another Yandex account. |
Inconsistent object | ||
6000 | Inconsistent object state |
|
6001 | Wrong object type specified |
|
6100 | The display region doesn't match the ad text (title, text, sitelinks) | When trying to change the display region in a group, the ad language was not appropriate for the new region (for example, the ad has Kazakh letters, but geotargeting is being changed to Russia) |
6101 | Language doesn't match geotargeting | When adding or modifying ads, display region compatibility was violated (for example, an ad was created in Ukrainian but geotargeting is set to Russia) |
Object restrictions | ||
7000 | Number of allowed elements exceeded or equal to zero |
|
7001 | Reached the maximum number of objects |
|
7002 | This tracking system domain isn't supported | |
Request parsing errors | ||
55 | Operation not found | Invalid value specified for the method key in a JSON request. |
8000 | Invalid request |
|
Can't perform operation | ||
8300 | Invalid object status |
|
8301 | Can't delete object |
|
8302 | Displays can't be suspended | Attempt to suspend the only active keyword in a group (if there are no audience targets). |
8303 | Object can't be archived |
|
8304 | Object can't be unarchived |
|
8305 | Can't perform action | Attempt to change the daily budget amount more than 3 times during the same day. |
8312 | Can't build a report in online mode | A report with the specified parameters can only be generated in offline mode. Change processingMode in the HTTP request header. See the section Online and offline reports. |
8600 | Error enabling the shared account | |
Object not found | ||
8800 | Object not found |
|
Limits on the number of objects in operations in a single request | ||
9300 | Exceeded the limit on the number of objects in operations in a single request | Exceeded the maximum number of objects in the method's input array |
9301 | Selection condition is too broad | Exceeded the maximum number of selected adjustments. The total of the Limit and Offset values must not exceed 120,000. |
Dependency of bids on strategies | ||
9600 | The field does not correspond to the set strategy | The request does not have a field that is required in certain conditions (for example, Bid in the Bids.Set method for manual display strategies). |
9601 | Bid can't be changed |
|
Duplicated objects | ||
9800 | An object can't be in the request more than once | A single call of the update, set, or delete method contains multiple objects with the same ID |
9801 | An object with the specified characteristics already exists | Attempt to add an adjustment that already exists (for example, repeatedly adding a mobile adjustment or an adjustment for the same target audience). |
9802 | An item can't be in the list more than once |
|
Error code | Message | Comments and possible reasons |
Server errors | ||
---|---|---|
52 | Authorization server temporarily unavailable | The Yandex Direct API server is temporarily unable to get information from the Yandex OAuth service. Try calling the method again later. |
1000 | Server temporarily unavailable | Internal error on the Yandex Direct API server. Try calling the method again later. If the error persists, contact the support service. |
1001 | Service initialization error | |
1002 | Operation error | |
1003 | Couldn't create a Yandex user account | An error occurred when creating the account. Try calling the method again later. |
1004 | Couldn't create client | An error occurred when creating a client in Yandex Direct. Try calling the method again later. Use a different username to repeat the request. |
1020 | Internal server error | The list of available currencies isn't defined. Contact support. |
Authentication error | ||
53 | Authorization error | Invalid OAuth token. For the reasons why a token may become invalid, see Revoking tokens in the Yandex OAuth guide. |
Incomplete app registration | ||
58 | Incomplete registration | You must submit a request for API access and wait for it to be approved. |
Permission errors | ||
54 | No rights |
|
513 | Your username is not enabled in Yandex Direct | The request is on behalf of a user who doesn't have a Yandex Direct account. To register an account, create an advertising campaign in this user's name in the web interface. See also Access and authorization. |
3000 | No API access |
|
3001 | No access to the method | Access to the AgencyClients.add method is granted to the agency on request. |
Restrictions, points | ||
152 | Not enough Yandex units | |
506 | Exceeded limit on number of connections | You have reached the maximum number of simultaneous connections to the Yandex Direct server. |
Unsupported fields, objects, and operations | ||
3500 | Not supported | Attempt to add bid adjustment is not compatible with the campaign type. |
3600 | Limited functionality | Attempt to use the PAY_FOR_CONVERSION or PAY_FOR_CONVERSION_PER_CAMPAIGN strategy. |
Invalid request parameters | ||
4000 | Invalid request parameters |
|
4001 | Invalid SelectionCriteria filter parameters |
|
4002 | Invalid page settings | Invalid value for the Limit or Offset parameter. |
4003 | All required parameters were omitted | The request must contain at least one parameter from the set, but none of them were specified. |
4004 | More than one parameter was passed | Mutually exclusive parameters were specified. Only one of them can be present in the request. |
4005 | A single type of Id must be used within a request | Bids are set with IDs of heterogeneous objects (for example, one Bids structure has CampaignId, but the other structure has AdGroupId). |
4006 | Incompatible operations are entered in the same request | To edit ad callouts, either use the ADD and REMOVE operations, or use the SET operation. |
Invalid field value | ||
5000 | Required field | A required field is empty, or the value consists of spaces. |
5001 | Exceeded allowed length |
|
5002 | Forbidden symbols used |
|
5003 | Empty value specified | There is an empty string, for example, in the Href parameter in an ad. |
5004 | Invalid format | Incorrect value for an object field, such as:
|
5005 | Field set incorrectly | Incorrect value for an object field, such as:
|
5006 | Invalid use of field |
|
5007 | Duplicated element | Sitelink texts are duplicates, or they link to the same webpage. |
5008 | All required fields were omitted | The object must have at least one field specified from the set, but none of them are specified. |
5009 | More than one field was passed | The object has mutually exclusive fields specified. |
5010 | Invalid field length | The field is too short. |
5100 | Incorrect template use | Incorrect use of templates (##) in the ad title and text. |
5120 | Geotargeting set incorrectly |
|
5140 | Keyword contains too many words | Exceeded the number of words in a keyword. |
5141 | Incorrect use of stop words | A keyword consists exclusively of stop words. |
5142 | Exceeded the maximum word length in a keyword | |
5160 | Negative keyword can't be a phrase | Attempt to use a negative keyword with a space in it. |
5161 | Incorrect use of negative keywords |
|
5162 | Exceed the maximum length of a negative keyword | |
5181 | You cannot change the advertised application | |
5200 | Login already in use | Attempt to create a client with a login name that is already used by another Yandex account. |
Inconsistent object | ||
6000 | Inconsistent object state |
|
6001 | Wrong object type specified |
|
6100 | The display region doesn't match the ad text (title, text, sitelinks) | When trying to change the display region in a group, the ad language was not appropriate for the new region (for example, the ad has Kazakh letters, but geotargeting is being changed to Russia) |
6101 | Language doesn't match geotargeting | When adding or modifying ads, display region compatibility was violated (for example, an ad was created in Ukrainian but geotargeting is set to Russia) |
Object restrictions | ||
7000 | Number of allowed elements exceeded or equal to zero |
|
7001 | Reached the maximum number of objects |
|
7002 | This tracking system domain isn't supported | |
Request parsing errors | ||
55 | Operation not found | Invalid value specified for the method key in a JSON request. |
8000 | Invalid request |
|
Can't perform operation | ||
8300 | Invalid object status |
|
8301 | Can't delete object |
|
8302 | Displays can't be suspended | Attempt to suspend the only active keyword in a group (if there are no audience targets). |
8303 | Object can't be archived |
|
8304 | Object can't be unarchived |
|
8305 | Can't perform action | Attempt to change the daily budget amount more than 3 times during the same day. |
8312 | Can't build a report in online mode | A report with the specified parameters can only be generated in offline mode. Change processingMode in the HTTP request header. See the section Online and offline reports. |
8600 | Error enabling the shared account | |
Object not found | ||
8800 | Object not found |
|
Limits on the number of objects in operations in a single request | ||
9300 | Exceeded the limit on the number of objects in operations in a single request | Exceeded the maximum number of objects in the method's input array |
9301 | Selection condition is too broad | Exceeded the maximum number of selected adjustments. The total of the Limit and Offset values must not exceed 120,000. |
Dependency of bids on strategies | ||
9600 | The field does not correspond to the set strategy | The request does not have a field that is required in certain conditions (for example, Bid in the Bids.Set method for manual display strategies). |
9601 | Bid can't be changed |
|
Duplicated objects | ||
9800 | An object can't be in the request more than once | A single call of the update, set, or delete method contains multiple objects with the same ID |
9801 | An object with the specified characteristics already exists | Attempt to add an adjustment that already exists (for example, repeatedly adding a mobile adjustment or an adjustment for the same target audience). |
9802 | An item can't be in the list more than once |
|
Warnings
Warning code | Message |
---|---|
10000 | The object is in the request more than once |
10020 | The object is already suspended. |
10021 | The object is not suspended. |
10022 | The object is already archived. |
10025 | The object is already marked as deleted |
10100 | The specified vCard duplicates a previously created vCard |
10120 | The specified set of sitelinks duplicates a previously created set |
10140 | Keyword already exists |
10141 | New keyword created as the result of updating |
10160 | Bid won't be applied |
10161 | Priority won't be applied |
10163 | Setting won't be changed |
10165 | Parameter won't be applied |
10175 | The setting with a higher priority will be used |
10200 | Ad already paused |
10201 | Ad not paused |
10202 | Ad already archived |
10203 | Ad not archived |
10240 | Keyword already stopped |
10241 | Keyword not stopped |
10242 | Dynamic text ad target is already stopped |
10243 | Dynamic text ad target is not stopped |
Warning code | Message |
---|---|
10000 | The object is in the request more than once |
10020 | The object is already suspended. |
10021 | The object is not suspended. |
10022 | The object is already archived. |
10025 | The object is already marked as deleted |
10100 | The specified vCard duplicates a previously created vCard |
10120 | The specified set of sitelinks duplicates a previously created set |
10140 | Keyword already exists |
10141 | New keyword created as the result of updating |
10160 | Bid won't be applied |
10161 | Priority won't be applied |
10163 | Setting won't be changed |
10165 | Parameter won't be applied |
10175 | The setting with a higher priority will be used |
10200 | Ad already paused |
10201 | Ad not paused |
10202 | Ad already archived |
10203 | Ad not archived |
10240 | Keyword already stopped |
10241 | Keyword not stopped |
10242 | Dynamic text ad target is already stopped |
10243 | Dynamic text ad target is not stopped |