На этой странице перечислены распространенные ошибки и приведены советы по их предотвращению и устранению. Полный список ошибок можно найти в справочниках по ошибкам . Для получения дополнительной поддержки посетите наш форум .
google.auth.exceptions.RefreshError
invalid_grant
Краткое содержание
Срок действия токена истек или он отозван.
Распространенные причины
Проекту Google Cloud Platform с экраном согласия OAuth, настроенным для внешнего типа пользователя и статусом публикации Testing выдается токен обновления, срок действия которого истекает через 7 дней.
Как справиться
Статус публикации вашего проекта Google — Testing , поэтому срок действия токена обновления истекает каждые 7 дней и возникает ошибка invalid_grant . Перейдите в консоль Google API и перейдите к экрану согласия OAuth. Затем измените статус публикации на In production следуя этим инструкциям, чтобы избежать истечения срока действия токена обновления через 7 дней.
Этот оператор нельзя использовать с подклассом Ad.
Распространенные причины
Попытка изменить атрибуты, отличные от status объявления.
Как справиться
Н/Д
Советы по профилактике
После создания объявления его нельзя изменить. Если вы хотите изменить объявление, вам необходимо создать новое объявление, а затем удалить старое. Однако status объявления можно изменить с помощью MutateAdGroupAds .
INVALID_INPUT
Краткое содержание
Одно из полей объявления содержит недопустимые символы.
Распространенные причины
Использование специальных символов в URL-адресах.
Как справиться
Н/Д
Советы по профилактике
Прежде чем отправлять запрос API, проверьте URL-адреса в своем приложении.
Группа объявлений добавляется или переименовывается, но ее название уже используется другой группой объявлений.
Распространенные причины
Создание новой группы объявлений с названием существующей активной или приостановленной группы объявлений.
Как справиться
Зарегистрируйте ошибку и отправьте пользователю сообщение об ошибке, при необходимости предлагая уникальное название группы объявлений или показывая список используемых названий.
Идентификатор клиента клиента не указан в HTTP-заголовке.
Распространенные причины
Не указан идентификатор клиента клиента в HTTP-заголовке.
Как справиться
Н/Д
Советы по профилактике
Идентификатор клиента клиента необходим для всех вызовов, поэтому убедитесь, что вы указали его в заголовке HTTP. Рассмотрите возможность использования наших клиентских библиотек , поскольку они сделают это за вас.
CUSTOMER_NOT_FOUND
Краткое содержание
Учетная запись для идентификатора клиента, указанного в заголовке, не найдена.
Распространенные причины
Попытка получить доступ к учетной записи, которая была только что создана до того, как учетная запись была установлена в серверной части.
Как справиться
Подождите первые пять минут, затем повторяйте попытку каждые 30 секунд.
Советы по профилактике
Подождите несколько минут после создания учетной записи, прежде чем отправлять против нее запросы.
GOOGLE_ACCOUNT_COOKIE_INVALID
Краткое содержание
Токен доступа в заголовке запроса либо недействителен, либо срок его действия истек.
Распространенные причины
Токен доступа признан недействительным.
Как справиться
Запросите новый токен. Если вы используете одну из наших клиентских библиотек, обратитесь к ее документации, чтобы узнать, как обновить токен.
Советы по профилактике
Храните и повторно используйте токены доступа до истечения срока их действия.
NOT_ADS_USER
Краткое содержание
Аккаунт Google, используемый для создания токена доступа, не связан ни с каким аккаунтом Google Рекламы.
Распространенные причины
Предоставленная информация для входа соответствует учетной записи Google, в которой не включена реклама Google.
Как справиться
Обязательно войдите в действующую учетную запись Google Рекламы (обычно управляющую учетную запись) для потока OAuth. Вы также можете пригласить учетную запись Google для доступа к существующей учетной записи Google Рекламы, войдя в свою управляющую учетную запись, выбрав соответствующую учетную запись клиента или управляющего, перейдя в Tools and Settings > Access and security , а затем добавив адрес электронной почты учетной записи Google.
Советы по профилактике
Н/Д
OAUTH_TOKEN_INVALID
Краткое содержание
Токен доступа OAuth в заголовке недействителен.
Распространенные причины
Ваш токен доступа, переданный с заголовком HTTP, неверен.
Как справиться
Н/Д
Советы по профилактике
Убедитесь, что вы передали правильный токен доступа, связанный с вашей учетной записью. Иногда его путают с токенами обновления и кодами авторизации. Если вы хотите получить учетные данные, позволяющие получить доступ ко всем клиентским учетным записям управляющей учетной записи, убедитесь, что вы получили токен обновления для управляющей учетной записи. Более подробную информацию см. в нашем руководстве по токенам доступа, токенам обновления и OAuth2 .
Доступ к учетной записи клиента невозможен, поскольку она не включена.
Распространенные причины
Это происходит, когда учетная запись клиента не завершила регистрацию или была деактивирована.
Как справиться
Войдите в пользовательский интерфейс Google Рекламы и убедитесь, что вы завершили процесс регистрации для этого аккаунта. Информацию о деактивированных аккаунтах см. в разделе Повторная активация отмененного аккаунта Google Рекламы .
Советы по профилактике
Вы можете заранее проверить, деактивирована ли учетная запись клиента, проверив статус ОТМЕНЕНО .
DEVELOPER_TOKEN_NOT_APPROVED
Краткое содержание
Токен разработчика одобрен для использования только с тестовыми учетными записями и при попытке доступа к нетестовой учетной записи.
Распространенные причины
Токен тестового разработчика использовался для доступа к нетестовой учетной записи.
Токен разработчика не допускается в проекте, отправленном в запросе.
Распространенные причины
Каждый проект консоли Google API можно связать с токеном разработчика только из одного управляющего аккаунта. После того как вы сделаете запрос к API Google Рекламы, токен разработчика будет навсегда связан с проектом консоли Google API. Если вы не используете новый проект консоли Google API, при выполнении запроса вы получите ошибку DEVELOPER_TOKEN_PROHIBITED .
Как справиться
Н/Д
Советы по профилактике
При переходе на токен разработчика под новым управляющим аккаунтом вам потребуется создать новый проект консоли API Google для запросов API Google Рекламы, в которых используется новый токен менеджера.
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, был неверным.
Распространенные причины
Это происходит при попытке создать токен обновления для пользователя, которому уже предоставлен доступ к запрашивающему приложению. Например, это может произойти при многократном запуске примера «Создать учетные данные пользователя» для одних и тех же учетных данных клиента OAuth и авторизующего пользователя.
Как справиться
Чтобы повторно создать токен обновления для заданной комбинации авторизующихся учетных данных пользователя и клиента OAuth, отзовите существующий токен обновления . Обратите внимание, что отзыв токена делает его непригодным для доступа к Google Ads API и делает недействительными все токены доступа, которые были созданы с помощью токена обновления.
Советы по профилактике
Обязательно храните токен обновления в безопасном месте, чтобы избежать необходимости его регенерации.
Запрос ссылался на ресурс, который не удалось найти.
Распространенные причины
Запрос попытался изменить или иным образом ссылаться на ресурс, который не существует или был удален. Или заданное имя ресурса имеет неправильный формат.
Как справиться
Используйте поисковый запрос, чтобы получить имя существующего ресурса перед отправкой запроса на изменение. Ознакомьтесь с руководствами по нашим клиентским библиотекам , которые включают документацию о том, как создавать действительные имена ресурсов на всех поддерживаемых языках.
Советы по профилактике
Не создавайте имена ресурсов вручную. Используйте один из вспомогательных методов, предлагаемых нашими клиентскими библиотеками.
Запрос пытается создать ресурс, из-за которого общее количество этих ресурсов превысит указанный предел.
Распространенные причины
Существует множество ограничений на количество ресурсов, которые могут существовать в определенных контекстах.
Как справиться
Определите ограничение, с которым вы столкнулись, просмотрев ограничения системы . Либо повторно используйте существующий ресурс, либо удалите ресурсы, чтобы освободить место для новых.
Советы по профилактике
Используйте поисковые запросы, чтобы отслеживать количество ресурсов, имеющих ограничения.
Заголовки или описания объявлений содержат слишком много текста.
Как справиться
Определите обнаруженное ограничение , соответствующим образом измените строку и повторно отправьте запрос.
Советы по профилактике
Помните об ограничениях длины строки.
,
На этой странице перечислены распространенные ошибки и приведены советы по их предотвращению и устранению. Полный список ошибок можно найти в справочниках по ошибкам . Для получения дополнительной поддержки посетите наш форум .
google.auth.exceptions.RefreshError
invalid_grant
Краткое содержание
Срок действия токена истек или он отозван.
Распространенные причины
Проекту Google Cloud Platform с экраном согласия OAuth, настроенным для внешнего типа пользователя и статусом публикации Testing выдается токен обновления, срок действия которого истекает через 7 дней.
Как справиться
Статус публикации вашего проекта Google — Testing , поэтому срок действия токена обновления истекает каждые 7 дней и возникает ошибка invalid_grant . Перейдите в консоль Google API и перейдите к экрану согласия OAuth. Затем измените статус публикации на In production следуя этим инструкциям, чтобы избежать истечения срока действия токена обновления через 7 дней.
Этот оператор нельзя использовать с подклассом Ad.
Распространенные причины
Попытка изменить атрибуты, отличные от status объявления.
Как справиться
Н/Д
Советы по профилактике
После создания объявления его нельзя изменить. Если вы хотите изменить объявление, вам необходимо создать новое объявление, а затем удалить старое. Однако status объявления можно изменить с помощью MutateAdGroupAds .
INVALID_INPUT
Краткое содержание
Одно из полей объявления содержит недопустимые символы.
Распространенные причины
Использование специальных символов в URL-адресах.
Как справиться
Н/Д
Советы по профилактике
Прежде чем отправлять запрос API, проверьте URL-адреса в своем приложении.
Группа объявлений добавляется или переименовывается, но ее название уже используется другой группой объявлений.
Распространенные причины
Создание новой группы объявлений с названием существующей активной или приостановленной группы объявлений.
Как справиться
Зарегистрируйте ошибку и отправьте пользователю сообщение об ошибке, при необходимости предлагая уникальное название группы объявлений или показывая список используемых названий.
Идентификатор клиента клиента не указан в HTTP-заголовке.
Распространенные причины
Не указан идентификатор клиента клиента в HTTP-заголовке.
Как справиться
Н/Д
Советы по профилактике
Идентификатор клиента клиента необходим для всех вызовов, поэтому убедитесь, что вы указали его в заголовке HTTP. Рассмотрите возможность использования наших клиентских библиотек , поскольку они сделают это за вас.
CUSTOMER_NOT_FOUND
Краткое содержание
Учетная запись для идентификатора клиента, указанного в заголовке, не найдена.
Распространенные причины
Попытка получить доступ к учетной записи, которая была только что создана до того, как учетная запись была установлена в серверной части.
Как справиться
Подождите первые пять минут, затем повторяйте попытку каждые 30 секунд.
Советы по профилактике
Подождите несколько минут после создания учетной записи, прежде чем отправлять против нее запросы.
GOOGLE_ACCOUNT_COOKIE_INVALID
Краткое содержание
Токен доступа в заголовке запроса либо недействителен, либо срок его действия истек.
Распространенные причины
Токен доступа признан недействительным.
Как справиться
Запросите новый токен. Если вы используете одну из наших клиентских библиотек, обратитесь к ее документации, чтобы узнать, как обновить токен.
Советы по профилактике
Храните и повторно используйте токены доступа до истечения срока их действия.
NOT_ADS_USER
Краткое содержание
Аккаунт Google, используемый для создания токена доступа, не связан ни с каким аккаунтом Google Рекламы.
Распространенные причины
Предоставленная информация для входа соответствует учетной записи Google, в которой не включена реклама Google.
Как справиться
Обязательно войдите в действующую учетную запись Google Рекламы (обычно управляющую учетную запись) для потока OAuth. Вы также можете пригласить учетную запись Google для доступа к существующей учетной записи Google Рекламы, войдя в свою управляющую учетную запись, выбрав соответствующую учетную запись клиента или управляющего, перейдя в Tools and Settings > Access and security , а затем добавив адрес электронной почты учетной записи Google.
Советы по профилактике
Н/Д
OAUTH_TOKEN_INVALID
Краткое содержание
Токен доступа OAuth в заголовке недействителен.
Распространенные причины
Ваш токен доступа, переданный с заголовком HTTP, неверен.
Как справиться
Н/Д
Советы по профилактике
Убедитесь, что вы передали правильный токен доступа, связанный с вашей учетной записью. Иногда его путают с токенами обновления и кодами авторизации. Если вы хотите получить учетные данные, позволяющие получить доступ ко всем клиентским учетным записям управляющей учетной записи, убедитесь, что вы получили токен обновления для управляющей учетной записи. Более подробную информацию см. в нашем руководстве по токенам доступа, токенам обновления и OAuth2 .
Доступ к учетной записи клиента невозможен, поскольку она не включена.
Распространенные причины
Это происходит, когда учетная запись клиента не завершила регистрацию или была деактивирована.
Как справиться
Войдите в пользовательский интерфейс Google Рекламы и убедитесь, что вы завершили процесс регистрации для этого аккаунта. Информацию о деактивированных аккаунтах см. в разделе Повторная активация отмененного аккаунта Google Рекламы .
Советы по профилактике
Вы можете заранее проверить, деактивирована ли учетная запись клиента, проверив статус ОТМЕНЕНО .
DEVELOPER_TOKEN_NOT_APPROVED
Краткое содержание
Токен разработчика одобрен для использования только с тестовыми учетными записями и при попытке доступа к нетестовой учетной записи.
Распространенные причины
Токен тестового разработчика использовался для доступа к нетестовой учетной записи.
Токен разработчика не допускается в проекте, отправленном в запросе.
Распространенные причины
Каждый проект консоли Google API можно связать с токеном разработчика только из одного управляющего аккаунта. После того как вы сделаете запрос к API Google Рекламы, токен разработчика будет навсегда связан с проектом консоли Google API. Если вы не используете новый проект консоли Google API, при выполнении запроса вы получите ошибку DEVELOPER_TOKEN_PROHIBITED .
Как справиться
Н/Д
Советы по профилактике
При переходе на токен разработчика под новым управляющим аккаунтом вам потребуется создать новый проект консоли API Google для запросов API Google Рекламы, в которых используется новый токен менеджера.
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, был неверным.
Распространенные причины
Это происходит при попытке создать токен обновления для пользователя, которому уже предоставлен доступ к запрашивающему приложению. Например, это может произойти при многократном запуске примера «Создать учетные данные пользователя» для одних и тех же учетных данных клиента OAuth и авторизующего пользователя.
Как справиться
Чтобы повторно создать токен обновления для заданной комбинации авторизующихся учетных данных пользователя и клиента OAuth, отзовите существующий токен обновления . Обратите внимание, что отзыв токена делает его непригодным для доступа к Google Ads API и делает недействительными все токены доступа, которые были созданы с помощью токена обновления.
Советы по профилактике
Обязательно храните токен обновления в безопасном месте, чтобы избежать необходимости его регенерации.
Запрос ссылался на ресурс, который не удалось найти.
Распространенные причины
Запрос попытался изменить или иным образом ссылаться на ресурс, который не существует или был удален. Или заданное имя ресурса имеет неправильный формат.
Как справиться
Используйте поисковый запрос, чтобы получить имя существующего ресурса перед отправкой запроса на изменение. Ознакомьтесь с руководствами по нашим клиентским библиотекам , которые включают документацию о том, как создавать действительные имена ресурсов на всех поддерживаемых языках.
Советы по профилактике
Не создавайте имена ресурсов вручную. Используйте один из вспомогательных методов, предлагаемых нашими клиентскими библиотеками.
Запрос пытается создать ресурс, из-за которого общее количество этих ресурсов превысит указанный предел.
Распространенные причины
Существует множество ограничений на количество ресурсов, которые могут существовать в определенных контекстах.
Как справиться
Определите ограничение, с которым вы столкнулись, просмотрев ограничения системы . Либо повторно используйте существующий ресурс, либо удалите ресурсы, чтобы освободить место для новых.
Советы по профилактике
Используйте поисковые запросы, чтобы отслеживать количество ресурсов, имеющих ограничения.
Заголовки или описания объявлений содержат слишком много текста.
Как справиться
Определите обнаруженное ограничение , соответствующим образом измените строку и повторно отправьте запрос.
Советы по профилактике
Помните об ограничениях длины строки.
,
На этой странице перечислены распространенные ошибки и приведены советы по их предотвращению и устранению. Полный список ошибок можно найти в справочниках по ошибкам . Для получения дополнительной поддержки посетите наш форум .
google.auth.exceptions.RefreshError
invalid_grant
Краткое содержание
Срок действия токена истек или он отозван.
Распространенные причины
Проекту Google Cloud Platform с экраном согласия OAuth, настроенным для внешнего типа пользователя и статусом публикации Testing выдается токен обновления, срок действия которого истекает через 7 дней.
Как справиться
Статус публикации вашего проекта Google — Testing , поэтому срок действия токена обновления истекает каждые 7 дней и возникает ошибка invalid_grant . Перейдите в консоль Google API и перейдите к экрану согласия OAuth. Затем измените статус публикации на In production следуя этим инструкциям, чтобы избежать истечения срока действия токена обновления через 7 дней.
Этот оператор нельзя использовать с подклассом Ad.
Распространенные причины
Попытка изменить атрибуты, отличные от status объявления.
Как справиться
Н/Д
Советы по профилактике
После создания объявления его нельзя изменить. Если вы хотите изменить объявление, вам необходимо создать новое объявление, а затем удалить старое. Однако status объявления можно изменить с помощью MutateAdGroupAds .
INVALID_INPUT
Краткое содержание
Одно из полей объявления содержит недопустимые символы.
Распространенные причины
Использование специальных символов в URL-адресах.
Как справиться
Н/Д
Советы по профилактике
Прежде чем отправлять запрос API, проверьте URL-адреса в своем приложении.
Группа объявлений добавляется или переименовывается, но ее название уже используется другой группой объявлений.
Распространенные причины
Создание новой группы объявлений с названием существующей активной или приостановленной группы объявлений.
Как справиться
Зарегистрируйте ошибку и отправьте пользователю сообщение об ошибке, при необходимости предлагая уникальное название группы объявлений или показывая список используемых названий.
Идентификатор клиента клиента не указан в HTTP-заголовке.
Распространенные причины
Не указан идентификатор клиента клиента в HTTP-заголовке.
Как справиться
Н/Д
Советы по профилактике
Идентификатор клиента клиента необходим для всех вызовов, поэтому убедитесь, что вы указали его в заголовке HTTP. Рассмотрите возможность использования наших клиентских библиотек , поскольку они сделают это за вас.
CUSTOMER_NOT_FOUND
Краткое содержание
Учетная запись для идентификатора клиента, указанного в заголовке, не найдена.
Распространенные причины
Попытка получить доступ к учетной записи, которая была только что создана до того, как учетная запись была установлена в серверной части.
Как справиться
Подождите первые пять минут, затем повторяйте попытку каждые 30 секунд.
Советы по профилактике
Подождите несколько минут после создания учетной записи, прежде чем отправлять против нее запросы.
GOOGLE_ACCOUNT_COOKIE_INVALID
Краткое содержание
Токен доступа в заголовке запроса либо недействителен, либо срок его действия истек.
Распространенные причины
Токен доступа признан недействительным.
Как справиться
Запросите новый токен. Если вы используете одну из наших клиентских библиотек, обратитесь к ее документации, чтобы узнать, как обновить токен.
Советы по профилактике
Храните и повторно используйте токены доступа до истечения срока их действия.
NOT_ADS_USER
Краткое содержание
Аккаунт Google, используемый для создания токена доступа, не связан ни с каким аккаунтом Google Рекламы.
Распространенные причины
Предоставленная информация для входа соответствует учетной записи Google, в которой не включена реклама Google.
Как справиться
Обязательно войдите в действующую учетную запись Google Рекламы (обычно управляющую учетную запись) для потока OAuth. Вы также можете пригласить учетную запись Google для доступа к существующей учетной записи Google Ads, вписавшись в свою учетную запись менеджера, выбрав рассматриваемую учетную запись клиента или менеджер, перейдя на Tools and Settings > Access and security , а затем добавили адрес электронной почты Google.
Советы по профилактике
Н/Д
OAUTH_TOKEN_INVALID
Краткое содержание
Токен доступа OAuth в заголовке недопустим.
Общие причины
Ваш токен доступа прошел с заголовком HTTP, был неверным.
Как справиться
Н/Д
Советы по профилактике
Убедитесь, что вы прошли правильный токен доступа, связанный с вашей учетной записью. Иногда его путают с токенами обновления и кодами авторизации. Если вы хотите получить учетные данные, которые могут получить доступ ко всем учетным записям клиентов в рамках учетной записи менеджера, убедитесь, что вы получите токен обновления для учетной записи Manager. Для получения более подробной информации см. Наше руководство по токену доступа и токен обновления и OAuth2 .
С учетной записью клиента не может быть доступна, потому что она не в состоянии включенного.
Общие причины
Это происходит, когда учетная запись клиента не закончила регистрацию или была деактивирована.
Как справиться
Войдите в пользовательский интерфейс Google Ads и убедитесь, что вы завершили процесс регистрации для этой учетной записи. Для деактивированных учетных записей см. Reactivate отмененную учетную запись Google Ads .
Советы по профилактике
Вы можете активно проверить, деактирована ли учетная запись клиента путем проверки статуса отмены .
DEVELOPER_TOKEN_NOT_APPROVED
Краткое содержание
Токен разработчика утвержден только для использования с тестовыми учетными записями и пытается получить доступ к непротяжной учетной записи.
Общие причины
Токен разработчика тестирования использовался для доступа к учетной записи без тестирования.
Токен разработчика не разрешен с помощью проекта, отправленного в запросе.
Общие причины
Каждый проект консоли Google API может быть связан с токеном разработчика только из одной учетной записи менеджера. После того, как вы сделаете запрос Google Ads API, токен разработчика постоянно сочетается с консольным проектом Google API. Если вы не используете новый проект консоли Google API, вы получите ошибку DEVELOPER_TOKEN_PROHIBITED при выполнении запроса.
Как справиться
Н/Д
Советы по профилактике
Если переход на токен разработчика в рамках новой учетной записи менеджера, вам необходимо создать новый проект Google API для Google ADS API, которые используют токен нового менеджера.
USER_PERMISSION_DENIED
Краткое содержание
У авторизованного клиента нет доступа к операционному клиенту.
Общие причины
Аутентификация в качестве пользователя с доступом к учетной записи менеджера, но не указал в запросе login-customer-id .
Как справиться
Н/Д
Советы по профилактике
Укажите login-customer-id в качестве идентификатора учетной записи менеджера без yephens ( - ). Клиентские библиотеки встроили поддержку для этого.
Значение ставки не является точным кратным минимальной единицей валюты учетной записи. Например, 0,015 долл. США ( 15000 в микро) не является действительной ставкой.
Общие причины
Н/Д
Как справиться
Н/Д
Советы по профилактике
Убедитесь, что предложения являются кратными минимального блока для валюты учетной записи.
BID_TOO_BIG
Краткое содержание
Ошибка возвращается, даже если ставка находится в рамках бюджета кампании.
Кампания добавляется или переименована, но название уже используется другой кампанией.
Общие причины
Создание новой кампании с названием существующей активной или приостановленной кампании.
Как справиться
Войдите в систему ошибки и представьте пользователю сообщение об ошибке, опционально предложив уникальное имя кампании или отображая список используемых имен.
Запрос рассчитывал и не может быть завершен достаточно быстро, чтобы вернуть ответ.
Общие причины
Был был сделан поисковый запрос, который сгенерировал слишком больший ответ, или запрос на мутат был слишком большим, чтобы обработать.
Как справиться
Подождите около 30 секунд, затем повторите запрос. Если ошибка устойчиво пытайтесь разбить запрос на несколько меньших запросов, которые можно выполнить быстрее.
Что -то неожиданное произошло при обработке запроса.
Общие причины
API не работает правильно из -за ошибки.
Как справиться
Повторите любые запросы, которые не удались с этой ошибкой, используя экспоненциальный график отступления для RESRIES.
Советы по профилактике
Н/Д
TRANSIENT_ERROR
Краткое содержание
Проходила переходная внутренняя ошибка, и должна быть выполнена повторная попытка.
Общие причины
Эта ошибка возникает, когда API внутренне сталкивается с временной проблемой.
Как справиться
Повторите любые запросы, которые не удались с этой ошибкой, используя экспоненциальный график отступления для RESRIES.
Советы по профилактике
Н/Д
InvalidGrantError
invalid_grant (malformed auth code)
Краткое содержание
Код авторизации, обменяемый на токены OAuth, был уменен.
Общие причины
Это происходит при попытке создать токен обновления для пользователя, которому уже был предоставлен доступ к запрашивающей заявке. Например, это может произойти при запуске примера Generate пользователя более одного раза для тех же учетных данных клиента OAuth и авторизации пользователя.
Как справиться
Чтобы восстановить токен обновления для данной комбинации авторизации учетных данных пользователя и клиента OAuth, отмените существующий токен обновления . Обратите внимание, что отзыв токена делает его непригодным для API Google API и недействительным любые токены доступа, которые использовался токен обновления.
Советы по профилактике
Обязательно храните свой токен обновления в безопасном месте, чтобы избежать необходимости регенерации.
Запрос упомянул ресурс, который не может быть найден.
Общие причины
Запрос попытался мутировать или иным образом ссылаться на ресурс, который не существует или был удален. Или заданное имя ресурса для ресурса узоренено.
Как справиться
Используйте запрос на поиск, чтобы получить имя ресурса для существующего ресурса, прежде чем отправить запрос Mutate. Просмотрите наши руководства по библиотеке клиентов , которые включают документацию о том, как построить допустимые имена ресурсов на каждом поддерживаемом языке
Советы по профилактике
Не создавайте имена ресурсов вручную. Используйте один из вспомогательных методов, предлагаемых нашими клиентскими библиотеками.
Запрос пытается создать ресурс, который приведет к тому, что общее количество этих ресурсов превышает указанный предел.
Общие причины
Существует несколько ограничений на количество ресурсов, которые могут существовать в определенных контекстах.
Как справиться
Определите предел, который встречается путем просмотра лимитов системы . Либо повторно используйте существующий ресурс, либо удалите ресурсы для создания пространства для новых.
Советы по профилактике
Используйте поисковые запросы, чтобы контролировать количество ресурсов, которые имеют ограничения.
Заголовки или описания рекламы содержат слишком много текста.
Как справиться
Определите предел , который встречается, соответственно измените строку и отправляйте запрос.
Советы по профилактике
Помните о пределах длины строки.
,
На этой странице перечислены общие ошибки и предоставляют советы по предотвращению и их обращению. Для получения полного списка ошибок просмотрите ссылки на ошибку . Для получения дополнительной поддержки посетите наш форум .
google.auth.exceptions.RefreshError
invalid_grant
Краткое содержание
Токен истек или отменен.
Общие причины
Проект Google Cloud Platform с экраном согласия OAuth, настроенный для внешнего типа пользователя и состояния публикации Testing , выпускается с истеканием токена обновления за 7 дней.
Как справиться
Статус публикации вашего проекта Google проводит Testing , поэтому токен обновления истекает каждые 7 дней и получает ошибку invalid_grant . Перейдите в консоли Google API и перейдите на экран согласия OAuth. Затем измените статус публикации в In production после этих инструкций, чтобы избежать истечения срока действия токена обновления за 7 дней.
Этот оператор не может быть использован с подклассом AD.
Общие причины
Попытка изменить атрибуты, кроме status объявления.
Как справиться
Н/Д
Советы по профилактике
Как только объявление создано, оно не может быть изменено. Если вы хотите изменить объявление, вы должны сделать новое объявление, а затем удалить старое. status рекламы, однако, модифицируется с использованием мутатедграупад .
INVALID_INPUT
Краткое содержание
Одно из полей в рекламе содержит неверные символы.
Общие причины
Использование специальных символов в URL.
Как справиться
Н/Д
Советы по профилактике
Проверьте URL -адреса в вашем приложении, прежде чем сделать запрос API.
LINE_TOO_WIDE
Краткое содержание
Одно из полей в AD было длиннее максимально допустимой длины. Смотрите о текстовой рекламе .
Общие причины
Имея слишком длинную линию текста.
Как справиться
Н/Д
Советы по профилактике
Проверьте длину линии, прежде чем сделать запрос API.
Группа рекламы добавляется или переименована, но название уже используется другой рекламной группой.
Общие причины
Создание новой рекламной группы с именем существующей активной или приостановленной рекламной группы.
Как справиться
Войдите в систему ошибки и представьте пользователю сообщение об ошибке, необязательно предложив уникальное имя группы объявлений или показывая список используемых имен.
123-456-7890 должен быть 1234567890. См. Запуск для получения подробной информации. См. Подробнее.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Краткое содержание
Идентификатор клиента клиента не был указан в заголовке 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, был неверным.
Как справиться
Н/Д
Советы по профилактике
Убедитесь, что вы прошли правильный токен доступа, связанный с вашей учетной записью. Иногда его путают с токенами обновления и кодами авторизации. Если вы хотите получить учетные данные, которые могут получить доступ ко всем учетным записям клиентов в рамках учетной записи менеджера, убедитесь, что вы получите токен обновления для учетной записи Manager. Для получения более подробной информации см. Наше руководство по токену доступа и токен обновления и OAuth2 .
С учетной записью клиента не может быть доступна, потому что она не в состоянии включенного.
Общие причины
Это происходит, когда учетная запись клиента не закончила регистрацию или была деактивирована.
Как справиться
Войдите в пользовательский интерфейс Google Ads и убедитесь, что вы завершили процесс регистрации для этой учетной записи. Для деактивированных учетных записей см. Reactivate отмененную учетную запись Google Ads .
Советы по профилактике
Вы можете активно проверить, деактирована ли учетная запись клиента путем проверки статуса отмены .
DEVELOPER_TOKEN_NOT_APPROVED
Краткое содержание
Токен разработчика утвержден только для использования с тестовыми учетными записями и пытается получить доступ к непротяжной учетной записи.
Общие причины
Токен разработчика тестирования использовался для доступа к учетной записи без тестирования.
Токен разработчика не разрешен с помощью проекта, отправленного в запросе.
Общие причины
Каждый проект консоли Google API может быть связан с токеном разработчика только из одной учетной записи менеджера. После того, как вы сделаете запрос Google Ads API, токен разработчика постоянно сочетается с консольным проектом Google API. Если вы не используете новый проект консоли Google API, вы получите ошибку DEVELOPER_TOKEN_PROHIBITED при выполнении запроса.
Как справиться
Н/Д
Советы по профилактике
Если переход на токен разработчика в рамках новой учетной записи менеджера, вам необходимо создать новый проект Google API для Google ADS API, которые используют токен нового менеджера.
USER_PERMISSION_DENIED
Краткое содержание
У авторизованного клиента нет доступа к операционному клиенту.
Общие причины
Аутентификация в качестве пользователя с доступом к учетной записи менеджера, но не указал в запросе login-customer-id .
Как справиться
Н/Д
Советы по профилактике
Укажите login-customer-id в качестве идентификатора учетной записи менеджера без yephens ( - ). Клиентские библиотеки встроили поддержку для этого.
Значение ставки не является точным кратным минимальной единицей валюты учетной записи. Например, 0,015 долл. США ( 15000 в микро) не является действительной ставкой.
Общие причины
Н/Д
Как справиться
Н/Д
Советы по профилактике
Убедитесь, что предложения являются кратными минимального блока для валюты учетной записи.
BID_TOO_BIG
Краткое содержание
Ошибка возвращается, даже если ставка находится в рамках бюджета кампании.
Кампания добавляется или переименована, но название уже используется другой кампанией.
Общие причины
Создание новой кампании с названием существующей активной или приостановленной кампании.
Как справиться
Войдите в систему ошибки и представьте пользователю сообщение об ошибке, опционально предложив уникальное имя кампании или отображая список используемых имен.
Запрос рассчитывал и не может быть завершен достаточно быстро, чтобы вернуть ответ.
Общие причины
Был был сделан поисковый запрос, который сгенерировал слишком больший ответ, или запрос на мутат был слишком большим, чтобы обработать.
Как справиться
Подождите около 30 секунд, затем повторите запрос. Если ошибка устойчиво пытайтесь разбить запрос на несколько меньших запросов, которые можно выполнить быстрее.
Что -то неожиданное произошло при обработке запроса.
Общие причины
API не работает правильно из -за ошибки.
Как справиться
Повторите любые запросы, которые не удались с этой ошибкой, используя экспоненциальный график отступления для RESRIES.
Советы по профилактике
Н/Д
TRANSIENT_ERROR
Краткое содержание
Проходила переходная внутренняя ошибка, и должна быть выполнена повторная попытка.
Общие причины
Эта ошибка возникает, когда API внутренне сталкивается с временной проблемой.
Как справиться
Повторите любые запросы, которые не удались с этой ошибкой, используя экспоненциальный график отступления для RESRIES.
Советы по профилактике
Н/Д
InvalidGrantError
invalid_grant (malformed auth code)
Краткое содержание
Код авторизации, обменяемый на токены OAuth, был уменен.
Общие причины
Это происходит при попытке создать токен обновления для пользователя, которому уже был предоставлен доступ к запрашивающей заявке. Например, это может произойти при запуске примера Generate пользователя более одного раза для тех же учетных данных клиента OAuth и авторизации пользователя.
Как справиться
Чтобы восстановить токен обновления для данной комбинации авторизации учетных данных пользователя и клиента OAuth, отмените существующий токен обновления . Обратите внимание, что отзыв токена делает его непригодным для API Google API и недействительным любые токены доступа, которые использовался токен обновления.
Советы по профилактике
Обязательно храните свой токен обновления в безопасном месте, чтобы избежать необходимости регенерации.
Запрос упомянул ресурс, который не может быть найден.
Общие причины
Запрос попытался мутировать или иным образом ссылаться на ресурс, который не существует или был удален. Или заданное имя ресурса для ресурса узоренено.
Как справиться
Используйте запрос на поиск, чтобы получить имя ресурса для существующего ресурса, прежде чем отправить запрос Mutate. Просмотрите наши руководства по библиотеке клиентов , которые включают документацию о том, как построить допустимые имена ресурсов на каждом поддерживаемом языке
Советы по профилактике
Не создавайте имена ресурсов вручную. Используйте один из вспомогательных методов, предлагаемых нашими клиентскими библиотеками.
Запрос пытается создать ресурс, который приведет к тому, что общее количество этих ресурсов превышает указанный предел.
Общие причины
Существует несколько ограничений на количество ресурсов, которые могут существовать в определенных контекстах.
Как справиться
Определите предел, который встречается путем просмотра лимитов системы . Либо повторно используйте существующий ресурс, либо удалите ресурсы для создания пространства для новых.
Советы по профилактике
Используйте поисковые запросы, чтобы контролировать количество ресурсов, которые имеют ограничения.
[[["Прост для понимания","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-03-29 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."]]],[]]
