Ошибки и предупреждения

На этой странице обсуждаются различные типы ошибок и предупреждений, с которыми вы можете столкнуться при использовании API Display & Video 360.

Ошибки API

Запросы к API, которые не могут быть выполнены, возвращают сообщение об ошибке. Запросы, возвращающие ошибки, засчитываются в квоту пользователя и будут учитываться при рассмотрении запросов на дополнительную квоту. Ответы на ошибки должны быть обработаны и обработаны, чтобы избежать ошибок в будущем.

Ответ об ошибке имеет следующий формат и включает код ответа HTTP, сообщение об ошибке и статус кода Google RPC :

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

Ниже приведен список распространенных ошибок API, а также рекомендуемые действия в случае их возврата:

Код ПКП Рекомендуемое действие
400 INVALID_ARGUMENT Возникла проблема с вашим запросом. Просмотрите поле сообщения в ответе об ошибке и соответствующим образом измените свой запрос.
401 UNAUTHENTICATED Ваш запрос не может быть должным образом аутентифицирован. Убедитесь, что вы включили в свой запрос действительные учетные данные OAuth. Для получения дополнительной информации об этом обратитесь к нашему руководству по началу работы .
403 PERMISSION_DENIED У вас нет разрешений, необходимых для выполнения вашего запроса. Убедитесь, что ваша учетная запись пользователя имеет необходимые разрешения для соответствующего партнера или рекламодателя.
404 NOT_FOUND Ресурс, который вы пытаетесь получить, не найден. Убедитесь, что используемый вами идентификатор верен и соответствует типу извлекаемого ресурса.
409 ABORTED Ресурс, который вы пытаетесь изменить, изменяется в другом месте. Подождите несколько секунд и повторите запрос.
429 RESOURCE_EXHAUSTED Вы превысили лимит скорости или ежедневную квоту запросов . Изучите использование API с помощью консоли Google API и измените свой рабочий процесс, чтобы он работал в рамках существующих ограничений квоты. Для получения дополнительной информации посетите нашу страницу «Оптимизация квот» .

Если ваши операции не могут быть выполнены в пределах установленной дневной квоты, вы можете запросить дополнительную квоту .

500 INTERNAL В API произошла внутренняя ошибка. Подождите несколько секунд и повторите запрос. Если ошибка не устранена, обратитесь в службу поддержки .
504 DEADLINE_EXCEEDED API потребовалось слишком много времени для выполнения запроса. Подождите несколько секунд и повторите запрос. Если ошибка не устранена, обратитесь в службу поддержки .

Ошибки SDF

API Display & Video 360 использует асинхронный метод для создания и загрузки файлов структурированных данных (SDF) . По этой причине ошибки, возникающие во время создания SDF, возвращаются в завершенной задаче загрузки SDF. Задача загрузки SDF, завершившаяся с error , помечается как выполненная, но в поле response вместо имени медиа-ресурса отображается заполненное поле ошибки, как показано в этом усеченном примере:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

Если при попытке создания файлов SDF вы получаете сообщение об ошибке, требующее действий, вам следует следовать ему соответствующим образом. Если сообщение об ошибке не дает однозначного ответа, мы рекомендуем следующие действия:

  • Убедитесь, что у вашего пользователя есть необходимые разрешения для доступа к ресурсам родительского партнера или рекламодателя .
  • Убедитесь, что идентификаторы, указанные в фильтре, точны, соответствуют предполагаемому типу ресурса и находятся в контексте данного корневого идентификатора .
  • Убедитесь, что вы не превышаете лимит в двадцать одновременных задач загрузки SDF на пользователя.

Если ошибки по-прежнему возникают, обратитесь в службу поддержки , чтобы сообщить о проблеме.

Неблокирующие предупреждения

Неблокирующие предупреждения назначаются позициям, чтобы указать на проблему, которая может повлиять на показ позиции. Подобные предупреждения передаются в пользовательском интерфейсе через баннер уведомлений. Эти предупреждения являются пассивными и перечислены в поле warningMessages позиции.

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

Профилактика

Многих проблем, вызывающих появление предупреждений о неблокировке, можно избежать путем правильной настройки параметров позиции, в том числе следующих:

  • Срок действия . Если срок действия позиции недействителен или срок действия родительского заказа на размещение истек, позиция выдаст предупреждение и не будет показываться. Чтобы избежать последней проблемы, убедитесь, что период действия позиции не заканчивается позже, чем срок действия ее родительского заказа на размещение.
  • Назначенные объявления . Если позиции не назначено действительное объявление , позиция выдаст предупреждение и не будет показываться.
  • Таргетинг . Если таргетинг позиции не назначен должным образом, позиция может выдать предупреждение, и показ может быть нарушен или вообще прекращен.

Если вы реплицируете конфигурации из существующей позиции, убедитесь, что существующая позиция не генерирует непредвиденных предупреждений.

Мониторинг

Проблемы, вызывающие предупреждения о неблокировке, могут возникнуть во время работы позиции. Чтобы убедиться в правильности показа ваших позиций, отслеживайте активные позиции на предмет новых предупреждений. Позиции можно получить массово с помощью функции advertisers.lineItems.list . Если позиция выдает неожиданное предупреждение, вам следует немедленно устранить проблему, чтобы уменьшить влияние на показ.

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