Ограничения использования

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

Ограничения квоты запросов API

API Display & Video 360 использует два типа ограничений:

  • Общие ограничения квоты , в которые учитываются все соответствующие запросы.
  • Ограничения квоты записи , против которых учитываются все соответствующие запросы на запись методов. Методы записи определяются как методы, такие как create , patch , delete или bulkEdit , которые изменяют ресурсы. Обратите внимание, что некоторые методы потребляют больше квоты на запись, чем другие.

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

Предел квоты для всего проекта

Следующие ограничения квот по умолчанию являются общими для всех ресурсов и методов API Display & Video 360:

  • Всего запросов в минуту на проект: 1500
  • Запросов на запись в минуту на проект: 700

Ограничения квоты запросов для конкретного рекламодателя

Методы, указывающие идентификатор рекламодателя в URL-адресе запроса, учитываются в дополнительных ограничениях квоты «на рекламодателя на проект».

Все запросы с идентификатором рекламодателя, указанным в их URL-пути, например запросы к службам advertisers.lineItems , advertisers.creatives или advertisers.channels , будут учитываться в следующих ограничениях квоты:

  • Всего запросов в минуту на рекламодателя в проекте: 300
  • Запросов на запись в минуту на одного рекламодателя на проект: 150

Методы интенсивной записи

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

При расчете потребления квоты запросов на запись запросы к методам с интенсивным использованием записи учитываются как 5 запросов на запись. Например, 100 стандартных запросов на запись и 21 запрос с интенсивной записью (ни один из которых не указывает рекламодателя), сделанные в течение минуты, будут засчитаны как 205 запросов на запись ( 100 + (21 * 5) = 205 ) и превысят существующий общий запрос. ограничение квоты 200 запросов на запись в минуту.

Следующие методы считаются интенсивными по записи:

Превышение квоты

В том маловероятном случае, если ваш запрос не будет выполнен из-за превышения лимита запросов API, API вернет код состояния HTTP и причину ошибки. Кроме того, тело ответа содержит подробное описание причины ошибки.

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

Код ПКП Сообщение Рекомендованное действие
429 RESOURCE_EXHAUSTED Ресурс исчерпан (например, квота проверки). Изучите свое использование с помощью консоли Google API и измените свой рабочий процесс, чтобы лучше распараллеливать запросы, сделанные от разных рекламодателей, или, в более общем плане, замедлить скорость отправки запросов.

Увеличение квоты API Display & Video 360 не может быть запрошено.