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

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

google.auth.exceptions.RefreshError

invalid_grant
Краткое содержание Срок действия токена истек или он отозван.
Распространенные причины Проекту Google Cloud Platform с экраном согласия OAuth, настроенным для внешнего типа пользователя и статусом публикации Testing выдается токен обновления, срок действия которого истекает через 7 дней.
Как справиться Статус публикации вашего проекта Google — Testing поэтому срок действия токена обновления истекает каждые 7 дней и возникает ошибка invalid_grant . Перейдите в консоль Google API и перейдите к экрану согласия OAuth. Затем измените статус публикации на In production следуя этим инструкциям, чтобы избежать истечения срока действия токена обновления через 7 дней.
Советы по профилактике См. Непроверенные приложения .

AdError

CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR
Краткое содержание Этот оператор нельзя использовать с подклассом Ad.
Распространенные причины Попытка изменить атрибуты, отличные от status объявления.
Как справиться Н/Д
Советы по профилактике После того как объявление создано, его нельзя изменить. Если вы хотите изменить объявление, вам необходимо создать новое объявление, а затем удалить старое. Однако status объявления можно изменить с помощью MutateAdGroupAds .
INVALID_INPUT
Краткое содержание Одно из полей объявления содержит недопустимые символы.
Распространенные причины Использование специальных символов в URL-адресах.
Как справиться Н/Д
Советы по профилактике Прежде чем отправлять запрос API, проверьте URL-адреса в своем приложении.
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
Краткое содержание Две операции в одном запросе содержат операцию создания актива с одинаковыми двоичными данными.
Распространенные причины Запрос на изменение с дублированными операциями создания, содержащими одни и те же двоичные данные.
Как справиться Создайте ресурс в отдельном запросе, затем создайте ссылку на него в последующем запросе; или используйте временный идентификатор в том же запросе.
Советы по профилактике Н/Д

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
Краткое содержание Идентификатор клиента клиента не является числом.
Распространенные причины Использование неправильного идентификатора клиента.
Как справиться Н/Д
Советы по профилактике 123-456-7890 должен быть 1234567890. Подробности см. в разделе « Начало работы ».
CLIENT_CUSTOMER_ID_IS_REQUIRED
Краткое содержание Идентификатор клиента клиента не указан в HTTP-заголовке.
Распространенные причины Не указан идентификатор клиента клиента в HTTP-заголовке.
Как справиться Н/Д
Советы по профилактике Идентификатор клиента клиента необходим для всех вызовов, поэтому убедитесь, что вы указали его в заголовке HTTP. Рассмотрите возможность использования наших клиентских библиотек , поскольку они сделают это за вас.
CUSTOMER_NOT_FOUND
Краткое содержание Учетная запись для идентификатора клиента, указанного в заголовке, не найдена.
Распространенные причины Попытка получить доступ к учетной записи, которая была только что создана до того, как учетная запись была установлена ​​в серверной части.
Как справиться Подождите первые пять минут, затем повторяйте попытку каждые 30 секунд.
Советы по профилактике Подождите несколько минут после создания учетной записи, прежде чем отправлять против нее запросы.
Краткое содержание Токен доступа в заголовке запроса либо недействителен, либо срок его действия истек.
Распространенные причины Токен доступа признан недействительным.
Как справиться Запросите новый токен. Если вы используете одну из наших клиентских библиотек, обратитесь к ее документации, чтобы узнать, как обновить токен.
Советы по профилактике Храните и повторно используйте токены доступа до истечения срока их действия.
NOT_ADS_USER
Краткое содержание Аккаунт Google, используемый для создания токена доступа, не связан ни с каким аккаунтом Google Рекламы.
Распространенные причины Предоставленная информация для входа соответствует учетной записи Google, в которой не включена реклама Google.
Как справиться Обязательно войдите в действующую учетную запись Google Рекламы (обычно управляющую учетную запись) для потока OAuth. Вы также можете пригласить учетную запись Google для доступа к существующей учетной записи Google Рекламы, войдя в свою управляющую учетную запись, выбрав соответствующую учетную запись клиента или управляющего, перейдя в Tools and Settings > Access and security , а затем добавив адрес электронной почты учетной записи Google.
Советы по профилактике Н/Д
OAUTH_TOKEN_INVALID
Краткое содержание Токен доступа OAuth в заголовке недействителен.
Распространенные причины Ваш токен доступа, переданный с заголовком HTTP, неверен.
Как справиться Н/Д
Советы по профилактике Убедитесь, что вы передали правильный токен доступа, связанный с вашей учетной записью. Иногда его путают с токенами обновления и кодами авторизации. Если вы хотите получить учетные данные, позволяющие получить доступ ко всем клиентским учетным записям управляющей учетной записи, убедитесь, что вы получили токен обновления для управляющей учетной записи. Более подробную информацию см. в нашем руководстве по токенам доступа, токенам обновления и OAuth2 .

AuthorizationError

CUSTOMER_NOT_ENABLED
Краткое содержание Доступ к учетной записи клиента невозможен, поскольку она не включена.
Распространенные причины Это происходит, когда учетная запись клиента не завершила регистрацию или была деактивирована.
Как справиться Войдите в пользовательский интерфейс Google Рекламы и убедитесь, что вы завершили процесс регистрации для этого аккаунта. Информацию о деактивированных аккаунтах см. в разделе Повторная активация отмененного аккаунта Google Рекламы .
Советы по профилактике Вы можете заранее проверить, деактивирована ли учетная запись клиента, проверив статус ОТМЕНЕНО .
DEVELOPER_TOKEN_NOT_APPROVED
Краткое содержание Токен разработчика одобрен для использования только с тестовыми учетными записями и при попытке доступа к нетестовой учетной записи.
Распространенные причины Токен тестового разработчика использовался для доступа к нетестовой учетной записи.
Как справиться Убедитесь, что вы действительно хотите получить доступ к нетестовой учетной записи. Если да, то вам необходимо подать заявку на обновление вашего токена разработчика до стандартного или базового доступа.
Советы по профилактике Н/Д
DEVELOPER_TOKEN_PROHIBITED
Краткое содержание Токен разработчика не допускается в проекте, отправленном в запросе.
Распространенные причины Каждый проект консоли Google API можно связать с токеном разработчика только из одного управляющего аккаунта. После того как вы сделаете запрос к API Google Рекламы, токен разработчика будет навсегда связан с проектом консоли Google API. Если вы не используете новый проект консоли Google API, при выполнении запроса вы получите ошибку DEVELOPER_TOKEN_PROHIBITED .
Как справиться Н/Д
Советы по профилактике При переходе на токен разработчика под новым управляющим аккаунтом вам потребуется создать новый проект консоли API Google для запросов API Google Рекламы, в которых используется новый токен менеджера.
USER_PERMISSION_DENIED
Краткое содержание Авторизованный клиент не имеет доступа к действующему клиенту.
Распространенные причины Аутентификация пользователя с доступом к управляющему аккаунту, но без указания в запросе login-customer-id .
Как справиться Н/Д
Советы по профилактике Укажите login-customer-id в качестве идентификатора управляющего аккаунта без дефисов ( - ). Клиентские библиотеки имеют встроенную поддержку для этого.

BiddingError

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

CampaignBudgetError

MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC
Краткое содержание Сумма бюджета слишком мала.
Распространенные причины Н/Д
Как справиться Н/Д
Советы по профилактике Убедитесь, что сумма бюджета больше или равна минимальной единице валюты аккаунта.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT
Краткое содержание Сумма бюджета будет иметь слишком много значащих десятичных знаков при преобразовании из микросуммы в сумму в валюте аккаунта.
Распространенные причины Н/Д
Как справиться Н/Д
Советы по профилактике Убедитесь, что сумма бюджета делится на минимальную единицу валюты аккаунта.

CampaignError

DUPLICATE_CAMPAIGN_NAME
Краткое содержание Кампания добавляется или переименовывается, но это имя уже используется другой кампанией.
Распространенные причины Создание новой кампании с названием существующей активной или приостановленной кампании.
Как справиться Зарегистрируйте ошибку и отправьте пользователю сообщение об ошибке, при необходимости предлагая уникальное название кампании или показывая список используемых имен.
Советы по профилактике Н/Д

CriterionError

KEYWORD_HAS_INVALID_CHARS
Краткое содержание Добавление или редактирование ключевых слов, содержащих недопустимые символы.
Распространенные причины Используйте специальные символы, например ! @ % * в ключевых словах.
Как справиться Н/Д
Советы по профилактике Убедитесь, что вы не используете недопустимые символы в ключевых словах. См. раздел Добавление ключевых слов .

DistinctError

DUPLICATE_ELEMENT
Краткое содержание Запрос содержит два параметра, которые идентичны и избыточны.
Распространенные причины Н/Д
Как справиться Н/Д
Советы по профилактике Удалите дубликаты (операции, параметры, элементы списка) перед выполнением запроса. Найдите поля с ограничением DistinctElements .

InternalError

DEADLINE_EXCEEDED
Краткое содержание Время ожидания запроса истекло, и его не удалось выполнить достаточно быстро, чтобы вернуть ответ.
Распространенные причины Был сделан поисковый запрос, который вызвал слишком большой ответ, или запрос на изменение был слишком большим для обработки.
Как справиться Подождите около 30 секунд, затем повторите запрос. Если ошибка не устранена, попробуйте разбить запрос на несколько запросов меньшего размера, которые можно выполнить быстрее.
Советы по профилактике Просмотрите сегментацию , чтобы понять, как она может повлиять на размер ответа. Помните об ограничениях транспортного уровня gRPC .
INTERNAL_ERROR
Краткое содержание Во время обработки запроса произошло что-то непредвиденное.
Распространенные причины API работает неправильно из-за ошибки.
Как справиться Повторите все запросы, которые завершились неудачно с этой ошибкой, используя экспоненциальный график отсрочки повторных попыток.
Советы по профилактике Н/Д
TRANSIENT_ERROR
Краткое содержание Произошла временная внутренняя ошибка, необходимо выполнить повторную попытку.
Распространенные причины Эта ошибка возникает, когда внутри API возникает временная проблема.
Как справиться Повторите все запросы, которые завершились неудачно с этой ошибкой, используя экспоненциальный график отсрочки повторных попыток.
Советы по профилактике Н/Д

InvalidGrantError

invalid_grant (malformed auth code)
Краткое содержание Код авторизации, обмененный на токены OAuth, был неверным.
Распространенные причины Это происходит при попытке создать токен обновления для пользователя, которому уже предоставлен доступ к запрашивающему приложению. Например, это может произойти при многократном запуске примера «Создать учетные данные пользователя» для одних и тех же учетных данных клиента OAuth и авторизующего пользователя.
Как справиться Чтобы повторно создать токен обновления для заданной комбинации авторизующихся учетных данных пользователя и клиента OAuth, отзовите существующий токен обновления . Обратите внимание, что отзыв токена делает его непригодным для доступа к Google Ads API и делает недействительными все токены доступа, которые были созданы с помощью токена обновления.
Советы по профилактике Обязательно храните токен обновления в безопасном месте, чтобы избежать необходимости его регенерации.

MutateError

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

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
Краткое содержание Строка, назначенная указанному полю, длиннее предельного значения.
Распространенные причины Заголовки или описания объявлений содержат слишком много текста.
Как справиться Определите обнаруженное ограничение , соответствующим образом измените строку и повторно отправьте запрос.
Советы по профилактике Помните об ограничениях длины строки.