Распространенные ошибки

В этом руководстве перечислены распространенные ошибки API и предложены стратегии для их предотвращения и устранения.

Полный список всех типов ошибок см. в справочнике ошибок Google Ads API . Если вам нужна дополнительная помощь, задайте вопрос на форуме Google Ads API .

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT
Краткое содержание Токен доступа OAuth 2.0 не обладает необходимыми областями действия.
Распространенные причины Запрос отклонен, поскольку предоставленный токен доступа не включает область действия OAuth 2.0 API Google Ads.
Как поступить Убедитесь, что токен доступа имеет необходимые области действия (scopes). Распространенная причина этой ошибки — повторное использование существующего токена доступа, сгенерированного с использованием другого набора областей действия OAuth. Пример генерации нового токена доступа с необходимыми областями действия см. в параметрах авторизации OAuth.
Советы по профилактике Убедитесь, что токен доступа имеет необходимые области действия. Повторно аутентифицируйте пользователя с необходимыми областями действия, чтобы получить доступ с требуемыми областями действия. Если ваше приложение использует несколько областей действия OAuth, вам может потребоваться реализовать детализированные разрешения OAuth .

google.auth.exceptions.RefreshError

invalid_grant
Краткое содержание Срок действия токена истек или он был аннулирован.
Распространенные причины Проекту Google Cloud Platform, в котором настроен экран согласия OAuth для внешнего пользователя и установлен статус публикации Testing выдается токен обновления, срок действия которого истекает через 7 дней.
Как поступить Статус публикации вашего проекта Google — Testing , поэтому токен обновления истекает каждые 7 дней, и вы получаете ошибку invalid_grant . Перейдите в консоль Google API и откройте экран согласия OAuth . Затем измените статус публикации на In production , чтобы избежать истечения срока действия токена обновления через 7 дней.
Советы по профилактике См. раздел «Непроверенные приложения» .

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
Краткое содержание Идентификатор клиента (Customer ID) — это не число.
Распространенные причины Использование некорректного идентификатора клиента.
Как поступить Н/Д
Советы по профилактике Номер 123-456-7890 следует заменить на 1234567890. Подробности см. в разделе «Начало работы ».
CLIENT_CUSTOMER_ID_IS_REQUIRED
Краткое содержание В заголовке HTTP не был указан идентификатор клиента.
Распространенные причины В заголовке HTTP не указан идентификатор клиента.
Как поступить Н/Д
Советы по профилактике Для всех вызовов требуется идентификатор клиента, поэтому убедитесь, что вы указали его в заголовке HTTP. Рекомендуем использовать наши клиентские библиотеки, поскольку они обрабатывают это за вас.
CUSTOMER_NOT_FOUND
Краткое содержание Для указанного в заголовке идентификатора клиента не найдена учетная запись.
Распространенные причины Попытка доступа к учетной записи, которая была создана незадолго до того, как она была зарегистрирована в административной панели.
Как поступить Подождите первые пять минут, затем повторяйте попытку каждые 30 секунд.
Советы по профилактике Подождите несколько минут после создания учетной записи, прежде чем отправлять запросы к ней.
Краткое содержание Токен доступа в заголовке запроса либо недействителен, либо истек.
Распространенные причины Токен доступа был аннулирован.
Как поступить Запросите новый токен. Если вы используете одну из наших клиентских библиотек, обратитесь к ее документации, чтобы узнать, как обновить токен.
Советы по профилактике Храните и используйте токены доступа повторно до истечения срока их действия.
NOT_ADS_USER
Краткое содержание Учетная запись Google, использованная для генерации токена доступа, не связана ни с одной учетной записью Google Ads.
Распространенные причины Предоставленные данные для входа соответствуют учетной записи Google, в которой не включена реклама Google.
Как поступить Для аутентификации OAuth обязательно войдите в систему с помощью действующего аккаунта Google Ads (обычно это ваш управленческий аккаунт). Вы также можете пригласить аккаунт Google для доступа к существующему аккаунту Google Ads, войдя в свой управленческий аккаунт, выбрав нужный аккаунт клиента или менеджера, перейдя в раздел Tools and Settings > Access and security , а затем добавив адрес электронной почты аккаунта Google.
Советы по профилактике Н/Д
OAUTH_TOKEN_INVALID
Краткое содержание Токен доступа OAuth в заголовке недействителен.
Распространенные причины Переданный в HTTP-заголовке токен доступа был некорректным.
Как поступить Н/Д
Советы по профилактике Убедитесь, что вы передали правильный токен доступа, связанный с вашей учетной записью. Его иногда путают с токенами обновления и кодами авторизации. Если вы хотите получить учетные данные, позволяющие получить доступ ко всем учетным записям клиентов, находящихся под управлением менеджера, убедитесь, что вы получили токен обновления для учетной записи менеджера. См. руководство по аутентификации пользователей .

AuthorizationError

CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
Краткое содержание Проект Google Cloud доступен только для тестовых пользователей и не может использоваться для доступа к рабочим учетным записям.
Распространенные причины Для отправки запроса к нетестовому (производственному) аккаунту Google Ads использовался проект Google Cloud с уровнем доступа Test . (В версиях API v24 и более ранних эта ошибка возвращает AuthorizationError.ACTION_NOT_PERMITTED .)
Как поступить Если вы проводите тестирование, убедитесь, что ваш запрос нацелен на тестовый аккаунт . Если вы хотите получить доступ к рабочему аккаунту Google Ads, проверьте уровень доступа вашего проекта Google Cloud на странице обзора API Google Ads и повысьте уровень доступа вашего проекта до Explorer, Basic или Standard.
Советы по профилактике Н/Д
CUSTOMER_NOT_ENABLED
Краткое содержание Доступ к учетной записи клиента невозможен, поскольку она находится в неактивном состоянии.
Распространенные причины Это происходит, когда регистрация учетной записи клиента не завершена или она была деактивирована.
Как поступить Войдите в пользовательский интерфейс Google Ads и убедитесь, что вы завершили процесс регистрации для этой учетной записи. Для деактивированных учетных записей см. раздел «Восстановление активности в отмененной учетной записи Google Ads» .
Советы по профилактике Вы можете проверить, деактивирована ли учетная запись клиента, убедившись, что она имеет статус «ОТМЕНЕНО» .
USER_PERMISSION_DENIED
Краткое содержание Авторизованный клиент не имеет доступа к клиенту, осуществляющему эксплуатацию.
Распространенные причины Аутентификация пользователя с доступом к учетной записи менеджера, но без указания login-customer-id в запросе.
Как поступить Н/Д
Советы по профилактике Укажите login-customer-id как идентификатор учетной записи менеджера без дефисов ( - ). Клиентские библиотеки поддерживают это.