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

На этой странице перечислены типичные ошибки и приведены советы по их предотвращению и устранению. Полный список ошибок можно найти в справочнике по ошибкам, руководстве по пониманию ошибок API или руководстве по типам ошибок. Если вам нужна дополнительная помощь, обратитесь в службу поддержки Google Ads API.

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT

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

google.auth.exceptions.RefreshError

invalid_grant

Сводка Срок действия токена истек или он был отозван. Основные причины Проекту Google Cloud Platform с окном запроса доступа OAuth, настроенным для внешнего типа пользователя и статусом публикации Testing, выдается токен обновления со сроком действия 7 дней. Как обрабатывать Статус публикации вашего проекта Google – Testing, поэтому срок действия токена обновления истекает каждые семь дней и возникает ошибка invalid_grant. Перейдите в Google API Console и откройте окно запроса доступа OAuth. Затем измените статус публикации на In production, чтобы срок действия токена обновления не истек через 7 дней. Советы по предотвращению Подробнее о непроверенных приложениях…

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Сводка Этот оператор нельзя использовать с подклассом Ad. Основные причины Попытка изменить атрибуты, отличные от status объявления. Как обрабатывать – Советы по предотвращению После создания объявления его нельзя изменить. Можно лишь удалить его и создать новое. Однако status объявления можно изменить с помощью MutateAdGroupAds.
INVALID_INPUT	Сводка Одно из полей объявления содержит недопустимые символы. Основные причины Использование специальных символов в URL. Как поступить – Советы по предотвращению Проверяйте URL в приложении перед отправкой запроса к API.
LINE_TOO_WIDE	Сводка Одно из полей в объявлении превышает максимально допустимую длину. Подробнее о текстовых объявлениях… Основные причины Слишком длинная строка текста. Как поступить – Советы по предотвращению Проверьте длину строки, прежде чем отправлять запрос к API.

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	Сводка Этот ярлык уже связан с некоторыми объявлениями. Основные причины Попытка связать ярлык с объявлениями, с которыми он уже связан. Как обрабатывать – Советы по предотвращению Сначала проверьте, не связан ли уже ярлык, который вы хотите добавить, с объявлениями.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	Сводка Произведена попытка обновить удаленное объявление. Основные причины После удаления объявления его нельзя изменить, в том числе изменить его статус. Как обрабатывать – Советы по предотвращению Убедитесь, что ваш код не обновляет удаленные объявления.

AdGroupCriterionError
INVALID_KEYWORD_TEXT	Сводка Текст ключевого слова содержит недопустимые символы. Подробнее о том, как добавлять ключевые слова… Основные причины Текст ключевого слова содержит недопустимые символы. Как обрабатывать – Советы по предотвращению Проверяйте текст ключевого слова в приложении, прежде чем отправлять запрос к API.

AdGroupError

DUPLICATE_ADGROUP_NAME

Сводка При добавлении или переименовании группы объявлений используется название, уже назначенное другой группе объявлений. Основные причины Создание новой группы объявлений с названием существующей активной или приостановленной группы объявлений. Как обрабатывать Зарегистрируйте ошибку и покажите пользователю сообщение об ошибке. При необходимости предложите уникальное название группы объявлений или покажите список используемых названий. Советы по предотвращению –

AssetError

DUPLICATE_ASSET

Сводка Две операции в одном запросе содержат операцию создания объекта с одинаковыми двоичными данными. Основные причины Запрос mutate с дублирующимися операциями создания, содержащими одни и те же двоичные данные. Как поступить Создайте объект в отдельном запросе, а затем добавьте ссылку на него в следующем запросе или используйте временный идентификатор в том же запросе. Советы по предотвращению –

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Сводка Идентификатор клиента не является числом. Основные причины Используется неверный идентификатор клиента. Как обрабатывать – Советы по предотвращению Например, вместо 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 Рекламы. Основные причины Введенные логин и пароль относятся к аккаунту Google, с которым не связан аккаунт Google Реклама. Как поступить Убедитесь, что вы вошли в действительный аккаунт Google Рекламы (обычно это управляющий аккаунт) для процесса OAuth. Вы также можете предоставить аккаунту Google доступ к существующему аккаунту Google Рекламы. Для этого войдите в управляющий аккаунт, выберите нужный клиентский или управляющий аккаунт, перейдите к разделу Tools and Settings > Access and security и добавьте адрес электронной почты аккаунта Google. Советы по предотвращению –
OAUTH_TOKEN_INVALID	Сводка Токен доступа OAuth в заголовке недействителен. Основные причины Вы указали в заголовке HTTP недопустимый токен доступа. Как поступить – Советы по предотвращению Убедитесь, что вы передаете правильный токен доступа, связанный с вашим аккаунтом. Иногда его путают с токенами обновления и кодами авторизации. Если вы хотите получить учетные данные, которые позволят вам работать со всеми клиентскими аккаунтами, относящимися к управляющему аккаунту, то вам потребуется токен обновления для управляющего аккаунта. Подробная информация приведена в руководстве по аутентификации пользователей.

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	Сводка Облачный проект Google Cloud имеет только тестовый доступ, поэтому его нельзя использовать для доступа к рабочим аккаунтам. Основные причины Для отправки запроса в рабочий аккаунт Google Рекламы использовался облачный проект Google Cloud с тестовым уровнем доступа. (В версиях API 24 и более ранних это условие возвращает значение AuthorizationError.ACTION_NOT_PERMITTED.) Как обрабатывать Если вы проводите тестирование, убедитесь, что запрос отправляется в тестовый аккаунт. Если вы хотите получить доступ к рабочему аккаунту Google Рекламы, проверьте уровень доступа облачного проекта Google Cloud на обзорной странице Google Ads API и повысьте уровень доступа проекта до Explorer, базового или стандартного доступа. Советы по предотвращению –
CUSTOMER_NOT_ENABLED	Сводка Аккаунт клиента недоступен, поскольку он неактивен. Основные причины Это происходит, если регистрация аккаунта клиента не была завершена или он был деактивирован. Как обрабатывать Войдите в интерфейс Google Рекламы и убедитесь, что вы завершили процесс регистрации для этого аккаунта. Если аккаунт деактивирован, узнайте, как повторно активировать отмененный аккаунт Google Рекламы. Советы по предотвращению Вы можете заранее проверить, деактивирован ли аккаунт клиента, посмотрев статус CANCELLED.
USER_PERMISSION_DENIED	Сводка У авторизованного клиента нет доступа к операционному клиенту. Основные причины Выполняется аутентификация пользователя, у которого есть доступ к управляющему аккаунту, но в запросе не указан заголовок login-customer-id. Как обрабатывать – Советы по предотвращению Укажите login-customer-id в качестве идентификатора управляющего аккаунта без дефисов (-). Клиентские библиотеки поддерживают эту функцию.

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	Сводка Значение ставки не кратно минимальной единице валюты аккаунта. Например, ставка 0,015 долл.США (15000 в микроединицах) недействительна. Основные причины – Как обрабатывать – Советы по предотвращению Убедитесь, что ставки кратны минимальной единице валюты аккаунта.
BID_TOO_BIG	Сводка Ошибка возвращается, даже если ставка находится в пределах бюджета кампании. Основные причины – Как обрабатывать – Советы по предотвращению Проверьте, участвует ли аккаунт в программе Google Ad Grants. Если да, ограничьте цену за клик максимальным значением, предусмотренным программой.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	Сводка Бюджет слишком мал. Основные причины – Как обрабатывать – Советы по предотвращению Убедитесь, что сумма бюджета больше или равна минимальной единице валюты аккаунта.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	Сводка При конвертации суммы бюджета из микросуммы в сумму в валюте аккаунта будет слишком много значащих десятичных знаков. Основные причины – Как обрабатывать – Советы по предотвращению Убедитесь, что сумма бюджета делится на минимальную единицу валюты аккаунта.

CampaignError
DUPLICATE_CAMPAIGN_NAME	Сводка При добавлении или переименовании кампании используется название, уже назначенное другой кампании. Основные причины Произведена попытка создать новую кампанию с названием уже существующей (активной или приостановленной). Как обрабатывать Зарегистрируйте ошибку и покажите пользователю сообщение об ошибке. При необходимости предложите уникальное название кампании или покажите список используемых названий. Советы по предотвращению –
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE	Сводка Попытка изменить тип соответствия ключевых слов на уровне кампании, в которой включена функция AI Max. Основные причины При включении AI Max настройки широкого соответствия на уровне кампании перестают поддерживаться, поскольку все ключевые слова по умолчанию обрабатываются как имеющие широкое соответствие. При попытке задать или изменить это поле возникнет ошибка. Как поступить Посоветуйте пользователю использовать параметр disable_search_term_matching на уровне группы объявлений вместо того, чтобы настраивать широкое соответствие на уровне кампании. Советы по предотвращению Не задавайте для `keyword_match_type` значение `BROAD` (или любое другое) на уровне кампании, если для `ai_max_setting.enable_ai_max` задано значение `true`. Включайте и отключайте сопоставление поисковых запросов на уровне группы объявлений с помощью `disable_search_term_matching`.

CriterionError
KEYWORD_HAS_INVALID_CHARS	Сводка Добавление или изменение ключевых слов, содержащих недопустимые символы. Основные причины Использовать в ключевых словах специальные символы, например ! @ % *. Как обрабатывать – Советы по предотвращению Убедитесь, что вы не используете недопустимые символы в ключевых словах. Подробнее о том, как добавлять ключевые слова…

DistinctError
DUPLICATE_ELEMENT	Сводка Запрос содержит два идентичных и избыточных параметра. Основные причины – Как обрабатывать – Советы по предотвращению Удалите дубликаты (операции, параметры, элементы списка) перед отправкой запроса. Найдите поля с ограничением DistinctElements.

InternalError
DEADLINE_EXCEEDED	Сводка Время ожидания запроса истекло, и он не был выполнен достаточно быстро, чтобы вернуть ответ. Основные причины Запрос на поиск сгенерировал слишком большой ответ или запрос mutate был слишком большим для обработки. Как обрабатывать Подождите 30 сек., после чего повторно отправьте запрос. Если ошибка не исчезнет, попробуйте разбить запрос на несколько более мелких, которые можно выполнить быстрее. Советы по предотвращению Изучите раздел Сегментация, чтобы понять, как она может повлиять на размер ответа. Помните об ограничениях транспортного уровня gRPC.
INTERNAL_ERROR	Сводка При обработке запроса произошла неизвестная ошибка. Основные причины API работает неправильно из-за ошибки. Как обрабатывать Повторите все запросы, которые не удалось выполнить из-за этой ошибки, используя экспоненциальную выдержку. Советы по предотвращению –
TRANSIENT_ERROR	Сводка Произошла временная внутренняя ошибка. Повторите попытку. Основные причины Эта ошибка возникает, когда в API происходит временный сбой. Как поступить Повторите все запросы, которые не удалось выполнить из-за этой ошибки, используя экспоненциальную выдержку. Советы по предотвращению –

InvalidGrantError

invalid_grant (malformed auth code)

Сводка Код авторизации, обменянный на токены OAuth, был неправильно сформирован. Основные причины Это происходит при попытке создать токен обновления для пользователя, которому уже предоставлен доступ к запрашивающему приложению. Например, это может произойти, если вы запустите Generate User credentials example более одного раза для одних и тех же учетных данных клиента OAuth и авторизованного пользователя. Как обрабатывать Чтобы повторно сгенерировать токен обновления для определенной комбинации авторизующего пользователя и учетных данных клиента OAuth, отзовите существующий токен обновления. Обратите внимание, что после отзыва токен нельзя использовать для доступа к Google Ads API, а все токены доступа, созданные с помощью токена обновления, становятся недействительными. Советы по предотвращению Храните токен обновления в безопасном месте, чтобы не пришлось создавать его заново.

MutateError

RESOURCE_NOT_FOUND

Сводка Запрос относится к ресурсу, который не удалось найти. Основные причины В запросе была попытка изменить или иным образом сослаться на ресурс, который не существует или был удален. или указано недопустимое название ресурса. Как обрабатывать Чтобы получить название существующего ресурса, перед отправкой запроса mutate используйте поисковый запрос. Ознакомьтесь с руководствами по клиентским библиотекам, в которых рассказывается, как создавать допустимые названия ресурсов на всех поддерживаемых языках. Советы по предотвращению Не создавайте названия ресурсов вручную. Используйте один из вспомогательных методов, предлагаемых нашими клиентскими библиотеками.

NotEmptyError
EMPTY_LIST	Сводка Требуемый список пуст. Основные причины Передача пустого списка операций в метод mutate. Как обрабатывать – Советы по предотвращению –

QuotaError
RESOURCE_EXHAUSTED	Сводка Превышена максимальная допустимая частота запросов. Основные причины – Как обрабатывать – Советы по предотвращению Настройте небольшие задержки между запросами или объедините несколько операций в меньшее количество запросов.

RangeError
TOO_LOW	Сводка Значение ниже минимального допустимого. Основные причины Не указан идентификатор, поэтому передается значение 0. Как обрабатывать – Советы по предотвращению Просмотрите ограничения диапазонов, приведенные в документации по API.

RequestError
INVALID_INPUT	Сводка Запрос сформирован неправильно. Основные причины URL или контент запроса имеет неверный формат. Как поступить – Советы по предотвращению –
REQUIRED_FIELD_MISSING	Сводка В запросе отсутствует обязательная информация. Основные причины При попытке добавить объект не заполнены обязательные поля. Как обрабатывать Зарегистрируйте ошибку и покажите пользователю сообщение об ошибке. Атрибут fieldPath ошибки указывает, какое поле отсутствует. Советы по предотвращению Чтобы узнать, какие поля являются обязательными, ознакомьтесь со справочной документацией по API.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Сводка Запрос пытается создать ресурс, который приведет к превышению указанного лимита на общее количество таких ресурсов. Основные причины Существует несколько ограничений на количество ресурсов, которые могут существовать в определенных контекстах. Как обрабатывать Определите, какое ограничение действует, изучив системные ограничения. Используйте существующий ресурс или удалите ненужные ресурсы, чтобы освободить место для новых. Советы по предотвращению Используйте поисковые запросы, чтобы отслеживать количество ресурсов с ограничениями.

StringLengthError
TOO_LONG	Сводка Строка, назначенная указанному полю, превышает ограничение. Основные причины Заголовки или описания объявлений содержат слишком много текста. Как поступить Определите , какое ограничение было превышено, измените строку и отправьте запрос повторно. Советы по предотвращению Учитывайте ограничения на длину строк.