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

На этой странице описаны наиболее распространенные ошибки, возвращаемые Google Ad Manager API. Ошибки возвращаются в формате Error.REASON:

Ошибки, связанные с ограничениями для объектов

EntityChildrenLimitReachedError

Сводка
Достигнуто максимальное количество дочерних объектов, которые можно добавить к объекту.
Советы по обработке
Создайте новый объект того типа, для которого достигнуто максимальное количество дочерних объектов, и добавьте в него дочерний объект, который вы пытаетесь создать. Например, если вы получили сообщение LINE_ITEM_LIMIT_FOR_ORDER_REACHED, то вам нужно создать новый заказ и добавить в него позицию, которую вы пытаетесь создать.

Ошибки, связанные с квотами

QuotaError.EXCEEDED_QUOTA

Сводка
Количество запросов в секунду слишком велико и превышает допустимый лимит.
Советы по обработке
  • Используйте пакетные методы, например updateLineItems, чтобы собирать изменения локально и отправлять один запрос на их выполнение.
  • Подождите около пяти секунд и повторите запрос. Обратите внимание, что это не гарантирует успешное выполнение запроса. Если это не поможет, увеличьте время ожидания. Этот вариант рекомендуется для интерактивных приложений, интегрированных с Менеджером рекламы и используемых в режиме реального времени.
  • Ограничьте количество запросов до двух в секунду для сетей Менеджера рекламы и до восьми в секунду для сетей Менеджера рекламы 360. Это не гарантирует, что каждый запрос будет выполнен успешно, но может помочь снизить частоту возникновения этой ошибки. Этот вариант рекомендуется для приложений, интегрированных с Менеджером рекламы, которые не взаимодействуют с ним в режиме реального времени (например, для создания отчетов за ночь).

Ошибки аутентификации

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

Сводка
Пользователь попытался создать тестовую сеть, используя аккаунт, который уже связан с сетью.
Основные причины
Пользователь не создал аккаунт Google перед вызовом NetworkService.makeTestNetwork().
Советы по обработке
Создайте новый аккаунт, прежде чем вызывать NetworkService.makeTestNetwork(). Подробнее о том, как создать тестовую сеть…

AuthenticationError.NETWORK_CODE_REQUIRED

Сводка
Пользователь не предоставил networkCode. Для выполнения запроса требуется код сети.
Основные причины
Коды сетей обязательны для всех запросов, кроме NetworkService.getAllNetworks() и NetworkService.makeTestNetwork().
Советы по обработке
Включите в заголовок запроса код сети, к которой вы обращаетесь. Используйте только код сети, доступный для вашего аккаунта. Код сети можно найти на сайте Менеджера рекламы в разделе "Администрирование > Настройки размещения". Подробную информацию о том, как задать код сети, можно найти на странице Заголовки запросов и ответов SOAP XML.

AuthenticationError.NETWORK_NOT_FOUND

Сводка
Запрос не удалось выполнить, поскольку указанный в конфигурации код сети не найден на сервере.
Основные причины
В конфигурации указан неверный код сети.
Советы по обработке
В поле trigger (триггер) журнала ошибок часто указывается правильная сеть.

AuthenticationError.NO_NETWORKS_TO_ACCESS

Сводка
Пользователь не связан ни с одной сетью.
Основные причины
Вы не включили доступ к API для рабочего аккаунта.
Советы по обработке
Включите доступ к API для рабочей среды. Подробнее о том, как включить доступ к API…

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

Сводка
Клиент не включен в белый список для доступа к API.
Основные причины
Ваша сеть не добавлена в белый список для рабочей версии, но вы указали код сети в заголовке SOAP.
Советы по обработке
Включите доступ к API.

Ошибки, связанные с разрешениями

PermissionError.PERMISSION_DENIED

Сводка
У пользователя нет разрешения, необходимого для выполнения запроса.
Основные причины
  • Вы пытались получить доступ к объекту, который находится в другой сети.
  • Вы пытались получить доступ к объекту, который существует в вашей сети, но у вас нет разрешения на его чтение или обновление.
  • Вы пытались выполнить задачу, для которой требуется включить в аккаунте дополнительную функцию.
Советы по обработке
  • Если вы создаете пользовательский интерфейс, сообщите пользователю, что у него нет разрешения на выполнение этого действия и ему нужно обратиться к администратору.
  • Если вы пытались выполнить задачу, например связанную с функцией, доступной только в премиум-версии, и у вашей сети нет разрешения на это, обратитесь к менеджеру аккаунта, чтобы включить эту функцию.
  • Помните, что тестовые сети по умолчанию не являются сетями Менеджера рекламы 360, то есть в них нет платных функций, доступных в сетях Менеджера рекламы 360. Чтобы включить функции в тестовой сети, обратитесь к менеджеру аккаунта.

Ошибки версий

ApiVersionError.UPDATE_TO_NEWER_VERSION

Сводка
Приложение инициировало запрос, который требует более новой версии или относится к устаревшей версии.
Основные причины
  • Версия вызова API больше не поддерживается. Чтобы получать уведомления о прекращении поддержки, подпишитесь на наш блог.
  • Для выполнения запроса требуется более новая версия API. Часто это происходит, когда в интерфейсе появляется новая функция и для корректной отправки объекта через API требуется более новая версия API.
Советы по обработке
  • Следите за актуальными версиями API; планируйте регулярное обновление.
  • Чтобы получать уведомления о прекращении поддержки, подпишитесь на наш блог.

Ошибка 404

Сводка
Ваш запрос не дошел до сервера.
Основные причины
Возможно, подключение к интернету или прокси-сервер настроены неправильно. Версия API, которую вы вызываете, также может быть устаревшей.
Советы по обработке
Проверьте настройки интернета или прокси-сервера и убедитесь, что вы используете последнюю версию API. Рекомендуем также обновить клиентскую библиотеку до последней версии.
Советы по предотвращению
Чтобы быть в курсе последних новостей об Ad Manager API, посещайте справочный форум Менеджера рекламы и читайте наш блог.

Ошибка демаршалинга

Сводка
XML-код SOAP в запросе не соответствует спецификации WSDL.
Основные причины
Запрос содержит поля или объекты, не включенные в спецификацию WSDL, или неправильное пространство имен.
В запросе есть несоответствие типов (например, в поле для целого числа указано строковое значение).
Советы по обработке
Убедитесь, что запрос соответствует спецификации WSDL.
Используйте клиентскую библиотеку, чтобы сгенерировать действительный SOAP-запрос и сравнить его с вашим. Все клиентские библиотеки поддерживают ведение журналов запросов и ответов SOAP.