Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.
На этой странице перечислены распространенные ошибки и даны советы по их предотвращению и устранению. Для полного списка ошибок просмотрите ссылки на ошибки . Для получения дополнительной поддержки посетите наш форум .
google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
Краткое содержание
Токен доступа OAuth 2.0 не имеет требуемых областей действия.
Распространенные причины
Запрос отклонен, поскольку предоставленный токен доступа не включает область действия Google Ads API OAuth 2.0.
Как обращаться
Убедитесь, что токен доступа имеет требуемые области действия. Распространенной причиной этой ошибки является повторное использование существующего токена доступа, который был сгенерирован с использованием другого набора областей действия OAuth. См. параметры авторизации OAuth для примера того, как сгенерировать новый токен доступа с требуемыми областями действия.
Советы по профилактике
Убедитесь, что токен доступа имеет требуемые области действия. Повторно аутентифицируйте пользователя с требуемыми областями действия, чтобы получить доступ с требуемыми областями действия. Если ваше приложение использует несколько областей действия OAuth, вам может потребоваться реализовать разрешения Granular OAuth .
google.auth.exceptions.RefreshError
invalid_grant
Краткое содержание
Токен истек или отозван.
Распространенные причины
Проекту Google Cloud Platform с экраном согласия OAuth, настроенным для внешнего типа пользователя, и статусом публикации Testing выдается токен обновления, срок действия которого истекает через 7 дней.
Как обращаться
Статус публикации вашего проекта Google — Testing , поэтому токен обновления истекает каждые 7 дней и получает ошибку invalid_grant . Перейдите в Google API Console и перейдите на экран согласия OAuth. Затем измените статус публикации на In production следуя этим инструкциям, чтобы избежать истечения срока действия токена обновления через 7 дней.
Идентификатор клиента не был указан в заголовке HTTP.
Распространенные причины
Не указан идентификатор клиента в заголовке HTTP.
Как обращаться
Н/Д
Советы по профилактике
Для всех вызовов требуется идентификатор клиента, поэтому убедитесь, что вы указали его в заголовке HTTP. Рассмотрите возможность использования наших клиентских библиотек , поскольку они справятся с этим за вас.
CUSTOMER_NOT_FOUND
Краткое содержание
Для идентификатора клиента, указанного в заголовке, учетная запись не найдена.
Распространенные причины
Попытка получить доступ к учетной записи, которая была только что создана до того, как учетная запись была создана в бэкэнде.
Как обращаться
Подождите пять минут, затем повторяйте попытку каждые 30 секунд.
Советы по профилактике
Подождите несколько минут после создания учетной записи, прежде чем отправлять к ней запросы.
GOOGLE_ACCOUNT_COOKIE_INVALID
Краткое содержание
Токен доступа в заголовке запроса либо недействителен, либо срок его действия истек.
Распространенные причины
Токен доступа был аннулирован.
Как обращаться
Запросить новый токен. Если вы используете одну из наших клиентских библиотек, ознакомьтесь с ее документацией о том, как обновить токен.
Советы по профилактике
Храните и повторно используйте токены доступа до истечения срока их действия.
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 может быть связан только с одним токеном разработчика, но токен разработчика может быть связан с несколькими проектами в организации.
Доступ к учетной записи клиента невозможен, поскольку она не включена.
Распространенные причины
Это происходит, если учетная запись клиента не была зарегистрирована или была деактивирована.
Как обращаться
Войдите в пользовательский интерфейс Google Ads и убедитесь, что вы завершили процесс регистрации для этой учетной записи. Для деактивированных учетных записей см. раздел Повторная активация отмененной учетной записи Google Ads .
Советы по профилактике
Вы можете заранее проверить, деактивирована ли учетная запись клиента, проверив ее статус «ОТМЕНЕНО» .
DEVELOPER_TOKEN_NOT_APPROVED
Краткое содержание
Токен разработчика одобрен только для использования с тестовыми аккаунтами и попытками доступа к нетестовому аккаунту.
Распространенные причины
Для доступа к нетестовой учетной записи использовался тестовый токен разработчика.
Токен разработчика не допускается для проекта, отправленного в запросе.
Распространенные причины
Каждый проект 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 в качестве идентификатора учетной записи менеджера без дефисов ( - ). Клиентские библиотеки имеют встроенную поддержку для этого.
,
На этой странице перечислены распространенные ошибки и даны советы по их предотвращению и устранению. Для полного списка ошибок просмотрите ссылки на ошибки . Для получения дополнительной поддержки посетите наш форум .
google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
Краткое содержание
Токен доступа OAuth 2.0 не имеет требуемых областей действия.
Распространенные причины
Запрос отклонен, поскольку предоставленный токен доступа не включает область действия Google Ads API OAuth 2.0.
Как обращаться
Убедитесь, что токен доступа имеет требуемые области действия. Распространенной причиной этой ошибки является повторное использование существующего токена доступа, который был сгенерирован с использованием другого набора областей действия OAuth. См. параметры авторизации OAuth для примера того, как сгенерировать новый токен доступа с требуемыми областями действия.
Советы по профилактике
Убедитесь, что токен доступа имеет требуемые области действия. Повторно аутентифицируйте пользователя с требуемыми областями действия, чтобы получить доступ с требуемыми областями действия. Если ваше приложение использует несколько областей действия OAuth, вам может потребоваться реализовать разрешения Granular OAuth .
google.auth.exceptions.RefreshError
invalid_grant
Краткое содержание
Токен истек или отозван.
Распространенные причины
Проекту Google Cloud Platform с экраном согласия OAuth, настроенным для внешнего типа пользователя, и статусом публикации Testing выдается токен обновления, срок действия которого истекает через 7 дней.
Как обращаться
Статус публикации вашего проекта Google — Testing , поэтому токен обновления истекает каждые 7 дней и получает ошибку invalid_grant . Перейдите в Google API Console и перейдите на экран согласия OAuth. Затем измените статус публикации на In production следуя этим инструкциям, чтобы избежать истечения срока действия токена обновления через 7 дней.
Идентификатор клиента не был указан в заголовке HTTP.
Распространенные причины
Не указан идентификатор клиента в заголовке HTTP.
Как обращаться
Н/Д
Советы по профилактике
Для всех вызовов требуется идентификатор клиента, поэтому убедитесь, что вы указали его в заголовке HTTP. Рассмотрите возможность использования наших клиентских библиотек , поскольку они справятся с этим за вас.
CUSTOMER_NOT_FOUND
Краткое содержание
Для идентификатора клиента, указанного в заголовке, учетная запись не найдена.
Распространенные причины
Попытка получить доступ к учетной записи, которая была только что создана до того, как учетная запись была создана в бэкэнде.
Как обращаться
Подождите пять минут, затем повторяйте попытку каждые 30 секунд.
Советы по профилактике
Подождите несколько минут после создания учетной записи, прежде чем отправлять к ней запросы.
GOOGLE_ACCOUNT_COOKIE_INVALID
Краткое содержание
Токен доступа в заголовке запроса либо недействителен, либо срок его действия истек.
Распространенные причины
Токен доступа был аннулирован.
Как обращаться
Запросить новый токен. Если вы используете одну из наших клиентских библиотек, ознакомьтесь с ее документацией о том, как обновить токен.
Советы по профилактике
Храните и повторно используйте токены доступа до истечения срока их действия.
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 может быть связан только с одним токеном разработчика, но токен разработчика может быть связан с несколькими проектами в организации.
Доступ к учетной записи клиента невозможен, поскольку она не включена.
Распространенные причины
Это происходит, если учетная запись клиента не была зарегистрирована или была деактивирована.
Как обращаться
Войдите в пользовательский интерфейс Google Ads и убедитесь, что вы завершили процесс регистрации для этой учетной записи. Для деактивированных учетных записей см. раздел Повторная активация отмененной учетной записи Google Ads .
Советы по профилактике
Вы можете заранее проверить, деактивирована ли учетная запись клиента, проверив ее статус «ОТМЕНЕНО» .
DEVELOPER_TOKEN_NOT_APPROVED
Краткое содержание
Токен разработчика одобрен только для использования с тестовыми аккаунтами и попытками доступа к нетестовому аккаунту.
Распространенные причины
Для доступа к нетестовой учетной записи использовался тестовый токен разработчика.
Токен разработчика не допускается для проекта, отправленного в запросе.
Распространенные причины
Каждый проект 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 в качестве идентификатора учетной записи менеджера без дефисов ( - ). Клиентские библиотеки имеют встроенную поддержку для этого.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-06-04 UTC."],[[["This page provides solutions and preventative measures for common Google Ads API errors."],["For a comprehensive list of errors, refer to the dedicated error references section."],["Additional assistance and community support can be found on the Google Ads API forum."],["Understanding and addressing these errors is crucial for successful API integration and campaign management."]]],[]]