RequestError

  • This content describes an enum detailing possible request errors.

  • Errors range from missing or malformed resource names and IDs to issues with pagination parameters.

  • Other errors include invalid operations, immutable fields, too many mutate operations, and manager account restrictions.

  • Errors related to API specific parameters like developer token, login customer ID, and summary rows are also listed.

  • The enum also covers issues with RPC deadlines, unsupported API versions, and missing cloud projects.

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_MALFORMED

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.