Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.
На этой странице перечислены распространенные ошибки и даны советы по их предотвращению и устранению. Для полного списка ошибок просмотрите ссылки на ошибки . Для получения дополнительной поддержки посетите наш форум .
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 дней.
Этот оператор нельзя использовать с подклассом Ad.
Распространенные причины
Попытка изменить атрибуты, отличные от status объявления.
Как обращаться
Н/Д
Советы по профилактике
После создания объявления его нельзя изменить. Если вы хотите изменить объявление, вам необходимо создать новое объявление, а затем удалить старое. Однако status объявления можно изменить с помощью MutateAdGroupAds .
INVALID_INPUT
Краткое содержание
Одно из полей объявления содержит недопустимые символы.
Распространенные причины
Использование специальных символов в URL-адресах.
Как обращаться
Н/Д
Советы по профилактике
Перед выполнением запроса API проверьте URL-адреса в вашем приложении.
LINE_TOO_WIDE
Краткое содержание
Длина одного из полей объявления превысила максимально допустимую. См. О текстовых объявлениях .
Распространенные причины
Слишком длинная строка текста.
Как обращаться
Н/Д
Советы по профилактике
Перед выполнением запроса API проверьте длину строки.
Группа объявлений добавляется или переименовывается, но это имя уже используется другой группой объявлений.
Распространенные причины
Создание новой группы объявлений с названием существующей активной или приостановленной группы объявлений.
Как обращаться
Зарегистрируйте ошибку и представьте пользователю сообщение об ошибке, при желании предложив уникальное название группы объявлений или показав список используемых названий.
Идентификатор клиента не был указан в заголовке 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 в качестве идентификатора учетной записи менеджера без дефисов ( - ). Клиентские библиотеки имеют встроенную поддержку для этого.
Значение ставки не является точным кратным минимальной единице валюты счета. Например, 0,015 долл. США ( 15000 в микро) не является допустимой ставкой.
Распространенные причины
Н/Д
Как обращаться
Н/Д
Советы по профилактике
Убедитесь, что ставки кратны минимальной единице валюты счета.
BID_TOO_BIG
Краткое содержание
Ошибка возвращается, даже если ставка находится в пределах бюджета кампании.
Кампания добавляется или переименовывается, но это имя уже используется другой кампанией.
Распространенные причины
Создание новой кампании с названием существующей активной или приостановленной кампании.
Как обращаться
Зарегистрируйте ошибку и представьте пользователю сообщение об ошибке, при желании предложив уникальное название кампании или показав список используемых названий.
Запрос истек и не может быть выполнен достаточно быстро для возврата ответа.
Распространенные причины
Был сделан поисковый запрос, который сгенерировал слишком большой ответ, или запрос на мутацию оказался слишком большим для обработки.
Как обращаться
Подождите около 30 секунд, затем повторите запрос. Если ошибка повторяется, попробуйте разбить запрос на несколько меньших запросов, которые можно выполнить быстрее.
При обработке запроса произошло нечто непредвиденное.
Распространенные причины
API работает некорректно из-за ошибки.
Как обращаться
Повторите все запросы, завершившиеся с этой ошибкой, используя экспоненциальный график отсрочки для повторных попыток.
Советы по профилактике
Н/Д
TRANSIENT_ERROR
Краткое содержание
Произошла временная внутренняя ошибка, следует повторить попытку.
Распространенные причины
Эта ошибка возникает, когда API сталкивается с внутренней временной проблемой.
Как обращаться
Повторите все запросы, завершившиеся с этой ошибкой, используя экспоненциальный график отсрочки для повторных попыток.
Советы по профилактике
Н/Д
InvalidGrantError
invalid_grant (malformed auth code)
Краткое содержание
Код авторизации, обмененный на токены OAuth, был неверно сформирован.
Распространенные причины
Это происходит при попытке сгенерировать токен обновления для пользователя, которому уже был предоставлен доступ к запрашивающему приложению. Например, это может произойти при запуске примера Generate User credentials более одного раза для одних и тех же учетных данных клиента OAuth и авторизующего пользователя.
Как обращаться
Чтобы повторно сгенерировать токен обновления для заданной комбинации учетных данных авторизующего пользователя и клиента OAuth, отмените существующий токен обновления . Обратите внимание, что отзыв токена делает его непригодным для доступа к API Google Ads и делает недействительными любые токены доступа, для генерации которых использовался токен обновления.
Советы по профилактике
Обязательно сохраните свой токен обновления в безопасном месте, чтобы избежать необходимости его повторной генерации.
Запрос ссылался на ресурс, который не удалось найти.
Распространенные причины
Запрос пытался мутировать или иным образом ссылаться на ресурс, который не существует или был удален. Или заданное имя ресурса для ресурса неверно сформировано.
Как обращаться
Используйте поисковый запрос, чтобы получить имя ресурса для существующего ресурса перед отправкой запроса на изменение. Ознакомьтесь с нашими руководствами по клиентской библиотеке , которые включают документацию о том, как создавать допустимые имена ресурсов на каждом поддерживаемом языке
Советы по профилактике
Не создавайте имена ресурсов вручную. Используйте один из вспомогательных методов, предлагаемых нашими клиентскими библиотеками.
Запрос пытается создать ресурс, который приведет к тому, что общее количество этих ресурсов превысит указанный предел.
Распространенные причины
Существует множество ограничений на количество ресурсов, которые могут существовать в определенных контекстах.
Как обращаться
Определите ограничение, с которым вы столкнулись, просмотрев Системные ограничения . Либо повторно используйте существующий ресурс, либо удалите ресурсы, чтобы освободить место для новых.
Советы по профилактике
Используйте поисковые запросы для мониторинга количества ресурсов, имеющих ограничения.
[[["Прост для понимания","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."],[[["The Google Ads API returns a variety of errors related to authentication, ads, assets, bidding, and budgets, providing specific error codes for troubleshooting."],["Common causes of errors include invalid inputs, exceeding limits, and resource conflicts, necessitating careful validation of data and adherence to API guidelines."],["Suggested solutions involve correcting inputs, adjusting values to meet requirements, ensuring unique names, and retrying with exponential backoff for transient errors."],["Understanding the error codes and their corresponding descriptions enables developers to effectively diagnose and resolve issues encountered during API interactions."],["Developers should consult the Google Ads API documentation for detailed explanations of each error and recommended best practices to avoid them."]]],[]]