Interested in sharing your feedback about the Google Ads API?
Sign up to be invited to participate in user research!
RequestError
Stay organized with collections
Save and categorize content based on your preferences.
Enum describing possible request errors.
| Enums |
UNSPECIFIED
|
Enum unspecified. |
UNKNOWN
|
The received error code is not known in this version. |
RESOURCE_NAME_MISSING
|
Resource name is required for this request. |
|
Resource name provided is malformed. |
BAD_RESOURCE_ID
|
Resource name provided is malformed. |
INVALID_CUSTOMER_ID
|
Customer ID is invalid. |
OPERATION_REQUIRED
|
Mutate operation should have either create, update, or remove specified. |
RESOURCE_NOT_FOUND
|
Requested resource not found. |
INVALID_PAGE_TOKEN
|
Next page token specified in user request is invalid. |
EXPIRED_PAGE_TOKEN
|
Next page token specified in user request has expired. |
INVALID_PAGE_SIZE
|
Page size specified in user request is invalid. |
PAGE_SIZE_NOT_SUPPORTED
|
Setting the page size is not supported, and will be unavailable in a future version. |
REQUIRED_FIELD_MISSING
|
Required field is missing. |
IMMUTABLE_FIELD
|
The field cannot be modified because it's immutable. It's also possible that the field can be modified using 'create' operation but not 'update'. |
TOO_MANY_MUTATE_OPERATIONS
|
Received too many entries in request. |
CANNOT_BE_EXECUTED_BY_MANAGER_ACCOUNT
|
Request cannot be executed by a manager account. |
CANNOT_MODIFY_FOREIGN_FIELD
|
Mutate request was attempting to modify a readonly field. For instance, Budget fields can be requested for Ad Group, but are read-only for adGroups:mutate. |
INVALID_ENUM_VALUE
|
Enum value is not permitted. |
DEVELOPER_TOKEN_PARAMETER_MISSING
|
The developer-token parameter is required for all requests. |
LOGIN_CUSTOMER_ID_PARAMETER_MISSING
|
The login-customer-id parameter is required for this request. |
VALIDATE_ONLY_REQUEST_HAS_PAGE_TOKEN
|
page_token is set in the validate only request |
CANNOT_RETURN_SUMMARY_ROW_FOR_REQUEST_WITHOUT_METRICS
|
return_summary_row cannot be enabled if request did not select any metrics field. |
CANNOT_RETURN_SUMMARY_ROW_FOR_VALIDATE_ONLY_REQUESTS
|
return_summary_row should not be enabled for validate only requests. |
INCONSISTENT_RETURN_SUMMARY_ROW_VALUE
|
return_summary_row parameter value should be the same between requests with page_token field set and their original request. |
TOTAL_RESULTS_COUNT_NOT_ORIGINALLY_REQUESTED
|
The total results count cannot be returned if it was not requested in the original request. |
RPC_DEADLINE_TOO_SHORT
|
Deadline specified by the client was too short. |
UNSUPPORTED_VERSION
|
This API version has been sunset and is no longer supported. |
CLOUD_PROJECT_NOT_FOUND
|
The Google Cloud project in the request was not found. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-05-29 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-05-29 UTC."],[[["This enum outlines potential errors that may occur when making requests to the API."],["Errors can range from issues with resource names, customer IDs, and page tokens, to missing fields and invalid enum values."],["Certain requests require specific parameters like developer tokens and login customer IDs, the absence of which will trigger errors."],["The enum also covers scenarios where summary rows and total result counts cannot be returned based on the original request configuration."],["It also handles general API errors such as unsupported versions, missing projects, or exceeding request deadlines."]]],["This content defines various error types that can occur during API requests. These errors include issues with resource names (missing, malformed, or not found), invalid customer IDs, missing or incorrect operation specifications, and problems with pagination (invalid or expired tokens, page size issues). Other errors cover missing required fields, attempts to modify immutable or foreign fields, excessive mutate operations, account restrictions, invalid enum values, and missing request parameters. Additionally, errors related to summary row requests and version support are detailed.\n"]]
