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

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

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT

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

google.auth.exceptions.RefreshError

invalid_grant

Краткое содержание Токен истек или отозван. Распространенные причины Проекту Google Cloud Platform с экраном согласия OAuth, настроенным для внешнего типа пользователя, и статусом публикации Testing выдается токен обновления, срок действия которого истекает через 7 дней. Как обращаться Статус публикации вашего проекта Google — Testing , поэтому токен обновления истекает каждые 7 дней и выдаёт ошибку invalid_grant . Перейдите в консоль API Google и перейдите на экран согласия 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 Ads. Распространенные причины Предоставленная информация для входа соответствует учетной записи Google, в которой не включена реклама Google. Как обращаться Обязательно войдите в систему, используя действующий аккаунт Google Ads (обычно это ваш управляющий аккаунт) для входа по протоколу OAuth. Вы также можете пригласить аккаунт Google для доступа к существующему аккаунту Google Ads. Для этого войдите в свой управляющий аккаунт, выберите нужный клиентский или управляющий аккаунт, перейдите в Tools and Settings > Access and security и добавьте адрес электронной почты аккаунта Google. Советы по профилактике Н/Д
OAUTH_TOKEN_INVALID	Краткое содержание Токен доступа OAuth в заголовке недействителен. Распространенные причины Ваш токен доступа, переданный с заголовком HTTP, неверен. Как обращаться Н/Д Советы по профилактике Убедитесь, что вы передали правильный токен доступа, связанный с вашей учётной записью. Его иногда путают с токенами обновления и кодами авторизации. Если вы хотите получить учётные данные для доступа ко всем клиентским учётным записям в учётной записи менеджера, убедитесь, что вы получили токен обновления для учётной записи менеджера. См. руководство по аутентификации пользователей .
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN	Краткое содержание Токен разработчика уже связан с организацией Google Cloud и не может быть связан с другой организацией. Распространенные причины Токен разработчика не связан с проектом Google Cloud в той же организации Google Cloud, что и проект Google Cloud, который изначально использовался для выполнения запросов. Как обращаться Убедитесь, что идентификатор клиента OAuth связан с проектами Google Cloud в той же организации Google Cloud, если вы уже делали запросы API с токеном разработчика. Советы по профилактике Убедитесь, что все ваши проекты Google Cloud связаны с одной и той же организацией Google Cloud. Проект Google Cloud может быть связан только с одним токеном разработчика, но токен разработчика может быть связан с несколькими проектами в организации.
DEVELOPER_TOKEN_INVALID	Краткое содержание Токен разработчика недействителен. Распространенные причины Наиболее распространенными причинами этой ошибки являются опечатки в токене разработчика или неправильная установка токена разработчика в другом заголовке запроса. Как обращаться Обязательно скопируйте токен разработчика из API-центра, чтобы избежать опечаток. API-центр находится в вашем аккаунте Google Ads Manager. Также убедитесь, что токен разработчика указан в правильном заголовке. Токены разработчика иногда путают с токенами обновления OAuth и кодами авторизации. Подробнее о различных заголовках запросов читайте здесь . Советы по профилактике Н/Д

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

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, отзовите существующий токен обновления . Обратите внимание, что отзыв токена делает его непригодным для доступа к API Google Ads и делает недействительными все токены доступа, созданные с помощью этого токена обновления. Советы по профилактике Обязательно сохраните свой токен обновления в безопасном месте, чтобы избежать необходимости его повторной генерации.

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