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

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

Ошибки ограничения количества сущностей

EntityChildrenLimitReachedError

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

Ошибки квот

QuotaError.EXCEEDED_QUOTA

Краткое содержание
Количество запросов в секунду слишком велико и превысило допустимый лимит.
Рекомендуемые советы по обращению
  • Используйте пакетные методы, такие как updateLineItems , собирая изменения локально и отправляя один запрос для одновременного выполнения всех изменений.
  • Подождите около 5 секунд, а затем повторите запрос. Обратите внимание, что это не гарантирует успешного выполнения запроса. Если он снова не удастся, попробуйте увеличить время ожидания. Это рекомендуется для интерактивных приложений, интегрированных с Ad Manager и используемых в режиме реального времени.
  • Ограничьте количество запросов до 2 в секунду для сетей Ad Manager или до 8 в секунду для сетей Ad Manager 360. Ещё раз подчеркнём, что это не гарантирует успешного выполнения каждого запроса, но может помочь уменьшить количество ошибок. Это рекомендуется для приложений, интегрирующихся с Ad Manager, которые не предполагают взаимодействия в реальном времени, например, для создания ежедневных отчётов.

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

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

Краткое содержание
Пользователь попытался создать тестовую сеть, используя учетную запись, которая уже связана с какой-либо сетью.
Распространенные причины
Пользователь не создал новую учетную запись Google перед вызовом NetworkService.makeTestNetwork() .
Рекомендуемые советы по обращению
Перед вызовом NetworkService.makeTestNetwork() создайте совершенно новую учетную запись. Дополнительную информацию о создании тестовой сети см. в соответствующем разделе.

AuthenticationError.NETWORK_CODE_REQUIRED

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

AuthenticationError.NETWORK_NOT_FOUND

Краткое содержание
Запрос не может быть выполнен, поскольку сетевой код, указанный в конфигурации, не найден на сервере.
Распространенные причины
В вашей конфигурации указан неверный сетевой код.
Рекомендуемые советы по обращению
В поле «триггер» журнала ошибок часто указывается правильная сеть для пользователя.

AuthenticationError.NO_NETWORKS_TO_ACCESS

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

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

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

Ошибки доступа

PermissionError.PERMISSION_DENIED

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

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

ApiVersionError.UPDATE_TO_NEWER_VERSION

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

Ошибка 404

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

Ошибка десериализации

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