AuthorizationError

  • The content provides an enumeration of possible authorization errors.

  • Each enum value describes a specific type of authorization issue that can occur.

  • Examples of errors include permission denials, token issues, project access problems, and account status limitations.

Enum describing possible authorization errors.

Enums

UNSPECIFIED

Enum unspecified.

UNKNOWN

The received error code is not known in this version.

USER_PERMISSION_DENIED

User doesn't have permission to access customer. Note: If you're accessing a client customer, the manager's customer ID must be set in the login-customer-id header. Learn more at https://developers.google.com/google-ads/api/docs/concepts/call-structure#cid

DEVELOPER_TOKEN_NOT_ON_ALLOWLIST

The developer token is not on the allow-list.

DEVELOPER_TOKEN_PROHIBITED

The developer token is not allowed with the project sent in the request.

PROJECT_DISABLED

The Google Cloud project sent in the request does not have permission to access the api.

AUTHORIZATION_ERROR

Authorization of the client failed.

ACTION_NOT_PERMITTED

The user does not have permission to perform this action (for example, ADD, UPDATE, REMOVE) on the resource or call a method.

INCOMPLETE_SIGNUP

Signup not complete.

CUSTOMER_NOT_ENABLED

The customer account can't be accessed because it is not yet enabled or has been deactivated.

MISSING_TOS

The developer must sign the terms of service. They can be found here: ads.google.com/aw/apicenter

DEVELOPER_TOKEN_NOT_APPROVED

The developer token is only approved for use with test accounts. To access non-test accounts, apply for Basic or Standard access.

INVALID_LOGIN_CUSTOMER_ID_SERVING_CUSTOMER_ID_COMBINATION

The login customer specified does not have access to the account specified, so the request is invalid.

SERVICE_ACCESS_DENIED

The developer specified does not have access to the service.

ACCESS_DENIED_FOR_ACCOUNT_TYPE

The customer (or login customer) isn't in Google Ads. It belongs to another ads system.

METRIC_ACCESS_DENIED

The developer does not have access to the metrics queried.

CLOUD_PROJECT_NOT_UNDER_ORGANIZATION

The Google Cloud project is not under the required organization.

ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT

The user does not have permission to perform this action on the resource or method because the Google Ads account is suspended.