Квота

Ограничение по количеству запросов к API Display & Video 360 ограничивает частоту запросов, которые проект может отправлять к API.

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

Отправляйте запросы одновременно нескольким рекламодателям.

Квота API Display & Video 360 устанавливается для каждого проекта и для каждого рекламодателя. Квота проекта ограничивает количество запросов, отправляемых проектом. Квота рекламодателя ограничивает количество запросов, отправляемых проектом рекламодателю.

Чтобы использовать всю квоту проекта, отправляйте запросы одновременно нескольким рекламодателям.

Используйте параметры запроса list

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

Методы, list предлагают три ключевых параметра:

• pageSize задает количество ресурсов, которые могут быть возвращены запросом. Размер страницы по умолчанию зависит от метода. Установите максимальное значение, чтобы отображать больше ресурсов за один запрос.
• filter ограничивает список ресурсов заданными критериями. Установите этот параметр, чтобы отображалось только подмножество ресурсов. Дополнительную информацию см. в разделе «Фильтрация запросов списка» .
• orderBy упорядочивает перечисленные ресурсы по заданному свойству. Установите этот параметр, чтобы получить максимальное или минимальное значение списка ресурсов с меньшим количеством запросов.

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

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

Для получения более подробной информации об этих методах см. раздел «Массовые запросы» .

Идентификаторы кэша

Для многих действий API Display & Video 360 требуются идентификаторы, полученные с помощью API. Примеры включают идентификаторы параметров таргетинга и идентификаторы аудиторий Google . Храните идентификаторы локально, чтобы вам не приходилось постоянно их получать.

Использование идентификаторов для устаревших или удаленных ресурсов может привести к ошибке. Рекомендуется еженедельно получать кэшированные идентификаторы для подтверждения их статуса.

Используйте экспоненциальную задержку

Экспоненциальная задержка — это стратегия обработки ошибок. Она повторяет запросы с увеличением интервала времени.

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

В наших примерах кода для загрузки SDF используется экспоненциальная задержка при работе с клиентскими библиотеками. Ниже приведен пример использования экспоненциальной задержки:

• Получите объект Operation с помощью get запроса.
  • Если done не равно true, задача все еще выполняется.
  • Подождите 5 секунд + случайное количество секунд, затем повторите запрос.
• Восстановить операцию.
  • Если done не равно true, задача все еще выполняется.
  • Подождите 10 секунд + случайное количество секунд, затем повторите запрос.
• Восстановить операцию.
  • Если done не равно true, задача все еще выполняется.
  • Подождите 20 секунд + случайное количество секунд, затем повторите запрос.
• Восстановить операцию.
  • Если done не равно true, задача все еще выполняется.
  • Подождите 40 секунд + случайное количество секунд, затем повторите запрос.
• Восстановить операцию.
  • Если done не равно true, задача все еще выполняется.
  • Подождите 80 секунд + случайное количество секунд, затем повторите запрос.
• Продолжайте этот процесс до тех пор, пока не будет done значение «готово» или не будет достигнуто максимальное время.