Interested in sharing your feedback about the Google Ads API?
Sign up to be invited to participate in user research!
AuthorizationError
Stay organized with collections
Save and categorize content based on your preferences.
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. |
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-10-12 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-10-12 UTC."],[[["This enum lists potential authorization errors that may occur when accessing the Google Ads API."],["Errors can indicate issues with user permissions, developer tokens, project status, or account access."],["If a `login-customer-id` header is used when accessing a client customer, the manager's customer ID must be set for proper authorization."],["Developers must adhere to terms of service and ensure their tokens have the necessary approvals for accessing test or non-test accounts."],["Certain actions might be restricted for suspended Google Ads accounts, resulting in specific authorization errors."]]],["This document outlines authorization errors that can occur, including `UNKNOWN` errors and specific issues like `USER_PERMISSION_DENIED`, which requires setting a manager's customer ID. Developer token problems such as `DEVELOPER_TOKEN_NOT_ON_ALLOWLIST` and `DEVELOPER_TOKEN_PROHIBITED` are also covered. Access issues include `PROJECT_DISABLED`, `SERVICE_ACCESS_DENIED`, and `METRIC_ACCESS_DENIED`. Other problems include incomplete signups (`INCOMPLETE_SIGNUP`), missing terms of service (`MISSING_TOS`), and account-specific limitations, such as `ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT`.\n"]]
