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

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

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

EntityChildrenLimitReachedError

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

Ошибки квоты

QuotaError.EXCEEDED_QUOTA

Краткое содержание
Количество запросов, выполняемых в секунду, слишком велико и превысило допустимый предел.
Рекомендуемые советы по обращению
  • Используйте пакетные методы, такие как updateLineItems , собирая изменения локально и делая один запрос для одновременного выполнения всех этих изменений.
  • Подождите около 5 секунд и повторите запрос. Обратите внимание, что это не гарантирует, что запрос будет успешным. Если снова не получится, попробуйте увеличить время ожидания. Это рекомендуется для интерактивных приложений, интегрируемых с Менеджером рекламы и используемых в режиме реального времени.
  • Ограничьте количество запросов до 2 в секунду для сетей Менеджера рекламы или до 8 в секунду для сетей Менеджера рекламы 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

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

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

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

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

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

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

EntityChildrenLimitReachedError

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

Ошибки квоты

QuotaError.EXCEEDED_QUOTA

Краткое содержание
Количество запросов, выполняемых в секунду, слишком велико и превысило допустимый предел.
Рекомендуемые советы по обращению
  • Используйте пакетные методы, такие как updateLineItems , собирая изменения локально и делая один запрос для одновременного выполнения всех этих изменений.
  • Подождите около 5 секунд и повторите запрос. Обратите внимание, что это не гарантирует, что запрос будет успешным. Если снова не получится, попробуйте увеличить время ожидания. Это рекомендуется для интерактивных приложений, интегрируемых с Менеджером рекламы и используемых в режиме реального времени.
  • Ограничьте количество запросов до 2 в секунду для сетей Менеджера рекламы или до 8 в секунду для сетей Менеджера рекламы 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

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

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

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

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