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

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

ошибки API

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

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

{
  "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
Вы превысили лимит запросов или суточную квоту . Используйте консоль Google Cloud для анализа использования API. Обновите свой рабочий процесс, чтобы он работал в рамках существующих лимитов квоты. Для получения дополнительной информации см. наше руководство по оптимизации использования .
500 INTERNAL
В API произошла внутренняя ошибка. Подождите несколько секунд, а затем повторите запрос. Если ошибка повторяется, обратитесь в службу поддержки .
504 DEADLINE_EXCEEDED
API слишком долго обрабатывал запрос. Подождите несколько секунд и повторите запрос. Если ошибка сохраняется, обратитесь в службу поддержки .

Ошибки SDF

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

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

Если сообщение об ошибке неясно, рекомендуем следующее:

  • Убедитесь, что у вашего пользователя есть как минимум роль «Стандартный пользователь» для родительского партнера или рекламодателя .
  • Убедитесь, что идентификаторы, указанные в фильтре, верны. Идентификаторы должны соответствовать предполагаемому типу ресурса и являться дочерними ресурсами корневого идентификатора .
  • Убедитесь, что у пользователя одновременно выполняется менее двадцати задач загрузки SDF-файлов.

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

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

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

Причина появления предупреждения может повлиять на показ рекламного объявления. В некоторых случаях это может полностью предотвратить показ рекламы.

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

Некоторые неблокирующие предупреждения вызваны неправильной настройкой позиции заказа:

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

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

Мониторинг

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

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

  • Заказ на размещение товара приостановлен или истекает.
  • Использование списков пользователей или параметров таргетинга устарело.