Квоты

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

Ограничения квоты

Следующие ограничения квот по умолчанию являются общими для всех ресурсов и методов Bid Manager API.

• 2000 запросов на проект в день — можно увеличить .
• 4 запроса в секунду (QPS) на проект.
  • В консоли Google API эта квота называется количеством запросов в минуту на пользователя и равна 240.

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

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

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

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

Код	Причина	Сообщение	Рекомендованное действие
403	ежедневный лимит превышен	Дневной лимит превышен	Не повторяйте попытку, не устранив проблему. Изучите свое использование с помощью консоли Google API и измените свой рабочий процесс, чтобы делать меньше запросов. Вы можете запросить дополнительную квоту, если считаете, что ваше использование является разумным.
403	userRateLimitExceeded	Превышен лимит скорости пользователя	Замедлите скорость отправки запросов, используя экспоненциальную отсрочку .

Что такое экспоненциальный откат?

Экспоненциальная отсрочка — это стандартная стратегия обработки ошибок для сетевых приложений, при которой клиент периодически повторяет неудачный запрос в течение увеличивающегося промежутка времени. Если из-за большого объема запросов или интенсивного сетевого трафика сервер возвращает ошибки, экспоненциальная отсрочка может быть хорошей стратегией для обработки этих ошибок. И наоборот, это неподходящая стратегия для борьбы с ошибками, не связанными с объемом сети или временем ответа, такими как неверные учетные данные авторизации или ошибки «файл не найден».

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

Порядок реализации простого экспоненциального отката следующий:

1. Сделайте запрос к API.
2. Получите ответ HTTP 503 , который указывает, что вам следует повторить запрос.
3. Подождите 1 секунду + случайное_число_миллисекунд и повторите запрос.
4. Получите ответ HTTP 503 , который указывает, что вам следует повторить запрос.
5. Подождите 2 секунды + случайное_число_миллисекунд и повторите запрос.
6. Получите ответ HTTP 503 , который указывает, что вам следует повторить запрос.
7. Подождите 4 секунды + случайное_число_миллисекунд и повторите запрос.
8. Получите ответ HTTP 503 , который указывает, что вам следует повторить запрос.
9. Подождите 8 секунд + случайное_число_миллисекунд и повторите запрос.
10. Получите ответ HTTP 503 , который указывает, что вам следует повторить запрос.
11. Подождите 16 секунд + случайное_число_миллисекунд и повторите запрос.
12. Останавливаться. Сообщите или зарегистрируйте ошибку.

В приведенном выше потоке случайное_число_миллисекунды — это случайное число миллисекунд, меньшее или равное 1000. Это необходимо, поскольку введение небольшой случайной задержки помогает распределить нагрузку более равномерно и избежать возможности затормозить сервер. Значение Random_number_milli Seconds необходимо переопределять после каждого ожидания.

Примечание. Ожидание всегда равно (2 ^ n) + случайное_число_миллисекунд, где n — монотонно возрастающее целое число, изначально определенное как 0. Целое число n увеличивается на 1 для каждой итерации (каждого запроса).

Алгоритм настроен на завершение, когда n равно 5. Этот предел не позволяет клиентам бесконечно повторять попытки и приводит к общей задержке около 32 секунд, прежде чем запрос будет считаться «неустранимой ошибкой». Большее максимальное количество повторов допустимо, особенно если идет длительная загрузка; просто не забудьте ограничить задержку повторной попытки чем-то разумным, скажем, менее одной минуты.

Запрос дополнительной дневной квоты

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

Следующие инструкции применимы только к проектам, в которых возникла ошибка dailyLimitExceeded . Рекомендуемые действия при других ошибках квот описаны в таблице выше .

1. Перейдите к Bid Manager API в консоли Google API.
2. Просмотрите статистику использования на странице «Метрики» , чтобы убедиться, что ваше приложение работает должным образом. Прежде чем продолжить, обратите пристальное внимание на вызванные методы и устраните любое неожиданное или чрезмерное использование.
3. Если использование выглядит нормально, перейдите на страницу «Квоты» , щелкните значок редактирования рядом с пунктом «Запросов в день» и нажмите ссылку «Подать заявку на увеличение квоты».

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

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