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

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

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

google.rpc.ErrorInfo

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

google.auth.exceptions.RefreshError

invalid_grant
СводкаСрок действия токена истек или он был отозван.
Основные причины В проекте Google Cloud Platform с окном запроса доступа OAuth, настроенным для внешнего типа пользователей, и статусом публикации Testing токен обновления действует семь дней.
Как обрабатывать Статус публикации вашего проекта Google – Testing, поэтому срок действия токена обновления истекает каждые семь дней и возникает ошибка invalid_grant. Перейдите в Google API Console и откройте окно запроса доступа OAuth. Затем измените статус публикации на In production, чтобы срок действия токена обновления не истек через 7 дней.
Советы по предотвращению Подробнее о непроверенных приложениях…

AuthenticationError

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

AuthorizationError

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