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

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

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT

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

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	Краткое содержание Идентификатор клиента (Customer ID) — это не число. Распространенные причины Использование некорректного идентификатора клиента. Как поступить Н/Д Советы по профилактике Номер 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. Как поступить Для аутентификации OAuth обязательно войдите в систему с помощью действующего аккаунта Google Ads (обычно это ваш управленческий аккаунт). Вы также можете пригласить аккаунт 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 можно привязать токен разработчика только из одной учетной записи администратора. После отправки запроса к Google Ads API токен разработчика навсегда привязывается к проекту в Google API Console. Если вы не используете новый проект в Google API Console, при отправке запроса вы получите ошибку DEVELOPER_TOKEN_PROHIBITED . Как поступить Н/Д Советы по профилактике При переходе на токен разработчика в рамках новой учетной записи менеджера вам потребуется создать новый проект в консоли Google API для запросов к Google Ads API, использующих токен нового менеджера.
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	Краткое содержание Строка, присвоенная указанному полю, превышает допустимый предел. Распространенные причины В заголовках или описаниях рекламных объявлений содержится слишком много текста. Как поступить Определите достигнутый лимит , внесите соответствующие изменения в строку и отправьте запрос повторно. Советы по профилактике Учитывайте ограничения на длину строк.