Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
На этой странице перечислены распространенные ошибки и приведены советы по их предотвращению и устранению. Полный список ошибок можно найти в справочниках по ошибкам . Для получения дополнительной поддержки посетите наш форум .
google.auth.exceptions.RefreshError
invalid_grant
Краткое содержание
Срок действия токена истек или он отозван.
Распространенные причины
Проекту Google Cloud Platform с экраном согласия OAuth, настроенным для внешнего типа пользователя и статусом публикации Testing выдается токен обновления, срок действия которого истекает через 7 дней.
Как справиться
Статус публикации вашего проекта Google — Testing поэтому срок действия токена обновления истекает каждые 7 дней и возникает ошибка invalid_grant . Перейдите в консоль Google API и перейдите к экрану согласия OAuth. Затем измените статус публикации на In production следуя этим инструкциям, чтобы избежать истечения срока действия токена обновления через 7 дней.
Этот оператор нельзя использовать с подклассом Ad.
Распространенные причины
Попытка изменить атрибуты, отличные от status объявления.
Как справиться
Н/Д
Советы по профилактике
После того как объявление создано, его нельзя изменить. Если вы хотите изменить объявление, вам необходимо создать новое объявление, а затем удалить старое. Однако status объявления можно изменить с помощью MutateAdGroupAds .
INVALID_INPUT
Краткое содержание
Одно из полей объявления содержит недопустимые символы.
Распространенные причины
Использование специальных символов в URL-адресах.
Как справиться
Н/Д
Советы по профилактике
Прежде чем отправлять запрос API, проверьте URL-адреса в своем приложении.
Группа объявлений добавляется или переименовывается, но ее название уже используется другой группой объявлений.
Распространенные причины
Создание новой группы объявлений с названием существующей активной или приостановленной группы объявлений.
Как справиться
Зарегистрируйте ошибку и отправьте пользователю сообщение об ошибке, при необходимости предлагая уникальное название группы объявлений или показывая список используемых названий.
Использование неправильного идентификатора клиента.
Как справиться
Н/Д
Советы по профилактике
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 .
Доступ к учетной записи клиента невозможен, поскольку она не включена.
Распространенные причины
Это происходит, когда учетная запись клиента не завершила регистрацию или была деактивирована.
Как справиться
Войдите в пользовательский интерфейс Google Рекламы и убедитесь, что вы завершили процесс регистрации для этого аккаунта. Информацию о деактивированных аккаунтах см. в разделе Повторная активация отмененного аккаунта Google Рекламы .
Советы по профилактике
Вы можете заранее проверить, деактивирована ли учетная запись клиента, проверив статус ОТМЕНЕНО .
DEVELOPER_TOKEN_NOT_APPROVED
Краткое содержание
Токен разработчика одобрен для использования только с тестовыми учетными записями и при попытке доступа к нетестовой учетной записи.
Распространенные причины
Токен тестового разработчика использовался для доступа к нетестовой учетной записи.
Токен разработчика не допускается в проекте, отправленном в запросе.
Распространенные причины
Каждый проект консоли Google API можно связать с токеном разработчика только из одного управляющего аккаунта. После того как вы сделаете запрос к API Google Рекламы, токен разработчика будет навсегда связан с проектом консоли Google API. Если вы не используете новый проект консоли Google API, при выполнении запроса вы получите ошибку DEVELOPER_TOKEN_PROHIBITED .
Как справиться
Н/Д
Советы по профилактике
При переходе на токен разработчика под новым управляющим аккаунтом вам потребуется создать новый проект консоли API Google для запросов API Google Рекламы, в которых используется новый токен менеджера.
USER_PERMISSION_DENIED
Краткое содержание
Авторизованный клиент не имеет доступа к действующему клиенту.
Распространенные причины
Аутентификация пользователя с доступом к управляющему аккаунту, но без указания в запросе login-customer-id .
Как справиться
Н/Д
Советы по профилактике
Укажите login-customer-id в качестве идентификатора управляющего аккаунта без дефисов ( - ). Клиентские библиотеки имеют встроенную поддержку для этого.
Значение ставки не является кратным минимальной единице валюты аккаунта. Например, 0,015 доллара США ( 15000 в микро) не является действительной ставкой.
Распространенные причины
Н/Д
Как справиться
Н/Д
Советы по профилактике
Убедитесь, что ставки кратны минимальной единице валюты аккаунта.
BID_TOO_BIG
Краткое содержание
Ошибка возвращается, даже если ставка находится в пределах бюджета кампании.
Кампания добавляется или переименовывается, но это имя уже используется другой кампанией.
Распространенные причины
Создание новой кампании с названием существующей активной или приостановленной кампании.
Как справиться
Зарегистрируйте ошибку и отправьте пользователю сообщение об ошибке, при необходимости предлагая уникальное название кампании или показывая список используемых имен.
Время ожидания запроса истекло, и его не удалось выполнить достаточно быстро, чтобы вернуть ответ.
Распространенные причины
Был сделан поисковый запрос, который вызвал слишком большой ответ, или запрос на изменение был слишком большим для обработки.
Как справиться
Подождите около 30 секунд, затем повторите запрос. Если ошибка не устранена, попробуйте разбить запрос на несколько запросов меньшего размера, которые можно выполнить быстрее.
Во время обработки запроса произошло что-то непредвиденное.
Распространенные причины
API работает неправильно из-за ошибки.
Как справиться
Повторите все запросы, которые завершились неудачно с этой ошибкой, используя экспоненциальный график отсрочки повторных попыток.
Советы по профилактике
Н/Д
TRANSIENT_ERROR
Краткое содержание
Произошла временная внутренняя ошибка, необходимо выполнить повторную попытку.
Распространенные причины
Эта ошибка возникает, когда внутри API возникает временная проблема.
Как справиться
Повторите все запросы, которые завершились неудачно с этой ошибкой, используя экспоненциальный график отсрочки повторных попыток.
Советы по профилактике
Н/Д
InvalidGrantError
invalid_grant (malformed auth code)
Краткое содержание
Код авторизации, обмененный на токены OAuth, был неверным.
Распространенные причины
Это происходит при попытке создать токен обновления для пользователя, которому уже предоставлен доступ к запрашивающему приложению. Например, это может произойти при многократном запуске примера «Создать учетные данные пользователя» для одних и тех же учетных данных клиента OAuth и авторизующего пользователя.
Как справиться
Чтобы повторно создать токен обновления для заданной комбинации авторизующихся учетных данных пользователя и клиента OAuth, отзовите существующий токен обновления . Обратите внимание, что отзыв токена делает его непригодным для доступа к Google Ads API и делает недействительными все токены доступа, которые были созданы с помощью токена обновления.
Советы по профилактике
Обязательно храните токен обновления в безопасном месте, чтобы избежать необходимости его регенерации.
Запрос ссылался на ресурс, который не удалось найти.
Распространенные причины
Запрос попытался изменить или иным образом ссылаться на ресурс, который не существует или был удален. Или заданное имя ресурса имеет неверный формат.
Как справиться
Используйте поисковый запрос, чтобы получить имя существующего ресурса перед отправкой запроса на изменение. Ознакомьтесь с руководствами по нашим клиентским библиотекам , которые включают документацию о том, как создавать действительные имена ресурсов на всех поддерживаемых языках.
Советы по профилактике
Не создавайте имена ресурсов вручную. Используйте один из вспомогательных методов, предлагаемых нашими клиентскими библиотеками.
Запрос пытается создать ресурс, из-за которого общее количество этих ресурсов превысит указанный предел.
Распространенные причины
Существует множество ограничений на количество ресурсов, которые могут существовать в определенных контекстах.
Как справиться
Определите ограничение, с которым вы столкнулись, просмотрев ограничения системы . Либо повторно используйте существующий ресурс, либо удалите ресурсы, чтобы освободить место для новых.
Советы по профилактике
Используйте поисковые запросы, чтобы отслеживать количество ресурсов, имеющих ограничения.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2024-12-02 UTC."],[[["The Google Ads API returns a variety of errors related to authentication, ads, assets, bidding, and budgets, providing specific error codes for troubleshooting."],["Common causes of errors include invalid inputs, exceeding limits, and resource conflicts, necessitating careful validation of data and adherence to API guidelines."],["Suggested solutions involve correcting inputs, adjusting values to meet requirements, ensuring unique names, and retrying with exponential backoff for transient errors."],["Understanding the error codes and their corresponding descriptions enables developers to effectively diagnose and resolve issues encountered during API interactions."],["Developers should consult the Google Ads API documentation for detailed explanations of each error and recommended best practices to avoid them."]]],[]]
