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

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

google.rpc.ErrorInfo

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

google.auth.exceptions.RefreshError

invalid_grant
Краткое содержание Токен истек или отозван.
Распространенные причины Проекту Google Cloud Platform с экраном согласия OAuth, настроенным для внешнего типа пользователя, и статусом публикации Testing выдается токен обновления, срок действия которого истекает через 7 дней.
Как обращаться Статус публикации вашего проекта Google — Testing , поэтому токен обновления истекает каждые 7 дней и выдаёт ошибку invalid_grant . Перейдите в консоль API Google и перейдите на экран согласия 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 Ads.
Распространенные причины Предоставленная информация для входа соответствует учетной записи Google, в которой не включена реклама Google.
Как обращаться Обязательно войдите в систему, используя действующий аккаунт Google Ads (обычно это ваш управляющий аккаунт) для входа по протоколу OAuth. Вы также можете пригласить аккаунт Google для доступа к существующему аккаунту Google Ads. Для этого войдите в свой управляющий аккаунт, выберите нужный клиентский или управляющий аккаунт, перейдите в Tools and Settings > Access and security и добавьте адрес электронной почты аккаунта Google.
Советы по профилактике Н/Д
OAUTH_TOKEN_INVALID
Краткое содержание Токен доступа OAuth в заголовке недействителен.
Распространенные причины Ваш токен доступа, переданный с заголовком HTTP, неверен.
Как обращаться Н/Д
Советы по профилактике Убедитесь, что вы передали правильный токен доступа, связанный с вашей учётной записью. Его иногда путают с токенами обновления и кодами авторизации. Если вы хотите получить учётные данные для доступа ко всем клиентским учётным записям управляющей учётной записи, убедитесь, что у вас есть токен обновления для этой учётной записи. Подробнее см. в нашем руководстве по токенам доступа, токенам обновления и OAuth2 .
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 может быть связан с токеном разработчика только из одного аккаунта менеджера. После выполнения запроса к API Google Ads токен разработчика навсегда привязывается к проекту Google API Console. Если вы не используете новый проект Google API Console, при выполнении запроса возникнет ошибка DEVELOPER_TOKEN_PROHIBITED .
Как обращаться Н/Д
Советы по профилактике При переключении на токен разработчика в новой учетной записи менеджера вам потребуется создать новый проект консоли API Google для запросов API Google Ads, использующих токен нового менеджера.
USER_PERMISSION_DENIED
Краткое содержание Авторизованный клиент не имеет доступа к действующему клиенту.
Распространенные причины Аутентификация как пользователя с доступом к учетной записи менеджера, но без указания login-customer-id в запросе.
Как обращаться Н/Д
Советы по профилактике Укажите login-customer-id в качестве идентификатора учётной записи менеджера без дефисов ( - ). Клиентские библиотеки имеют встроенную поддержку для этого.

Назад
Сделать вызов API
Далее
Дальнейшие действия