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

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

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 секунд. Советы по профилактике Подождите несколько минут после создания учетной записи, прежде чем отправлять против нее запросы.
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 .

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 . В этом случае ограничьте цену за клик максимальным значением, предусмотренным программой .

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