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

На этой странице перечислены распространенные ошибки и даны советы по их предотвращению и устранению. Полный список ошибок см. в разделе «Справочная информация об ошибках» . Для получения дополнительной поддержки посетите наш форум .

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-заголовке токен доступа был некорректным.
Как поступить Н/Д
Советы по профилактике Убедитесь, что вы передали правильный токен доступа, связанный с вашей учетной записью. Его иногда путают с токенами обновления и кодами авторизации. Если вы хотите получить учетные данные, позволяющие получить доступ ко всем учетным записям клиентов, находящихся под управлением менеджера, убедитесь, что вы получили токен обновления для учетной записи менеджера. См. руководство по аутентификации пользователей .
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
Краткое содержание Токен разработчика уже связан с организацией Google Cloud и не может быть связан с другой организацией.
Распространенные причины Токен разработчика не связан с проектом Google Cloud в той же организации Google Cloud, что и проект Google Cloud, использованный для первоначального выполнения запросов.
Как поступить Убедитесь, что идентификатор клиента OAuth связан с проектами Google Cloud в той же организации Google Cloud, если вы уже отправляли запросы к API с использованием токена разработчика.
Советы по профилактике Убедитесь, что все ваши проекты Google Cloud связаны с одной и той же организацией Google Cloud. К одному проекту Google Cloud может быть привязан только один токен разработчика, но один токен разработчика может быть привязан к нескольким проектам в организации.
DEVELOPER_TOKEN_INVALID
Краткое содержание Токен разработчика недействителен.
Распространенные причины К распространённым причинам этой ошибки относятся опечатки в токене разработчика или некорректная установка токена разработчика в заголовке запроса, отличном от указанного.
Как поступить Чтобы избежать опечаток, обязательно скопируйте токен разработчика из центра API. Центр API можно найти в вашем аккаунте Google Ads Manager. Также убедитесь, что вы указываете токен разработчика в правильном заголовке. Токены разработчика иногда путают с токенами обновления OAuth и кодами авторизации. Подробнее о различных заголовках запроса можно прочитать здесь .
Советы по профилактике Н/Д

AuthorizationError

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

Назад
Обработка ошибок
Далее
Дальнейшие действия