Google Forms API – это общий сервис, поэтому мы применяем квоты и ограничения, чтобы обеспечить его справедливое использование всеми пользователями и защитить общую работоспособность системы Google Workspace.
Если вы превысите квоту, то, как правило, получите в ответ код статуса HTTP 429: Too many requests. В этом случае используйте алгоритм экспоненциальной выдержки и повторите попытку позже. Если вы не превышаете указанные ниже квоты на минуту, количество запросов в день не ограничено.
Примечание. Для отслеживания форм действуют дополнительные ограничения. Подробнее о том, как настроить и получать push-уведомления…
В таблице ниже приведены ограничения на запросы.
| Квоты | |||||||
|---|---|---|---|---|---|---|---|
| Запросы на чтение |
|
||||||
|
Дорогие запросы на чтение
(Используется для запросов |
|
||||||
| Запросы на запись |
|
||||||
Как устранить ошибки, связанные с временными квотами
Для всех ошибок, связанных со временем (максимум N запросов за X минут), мы рекомендуем, чтобы ваш код перехватывал исключение и использовал усеченную экспоненциальную выдержку, чтобы ваши устройства не генерировали чрезмерную нагрузку.
Экспоненциальная выдержка – это стандартная стратегия обработки ошибок для сетевых приложений. Алгоритм экспоненциальной выдержки повторяет запросы, экспоненциально увеличивая время ожидания между ними до максимального значения. Если запросы по-прежнему не выполняются, важно, чтобы задержки между ними со временем увеличивались, пока запрос не будет выполнен.
Пример алгоритма
Алгоритм экспоненциальной выдержки повторяет запросы экспоненциально, увеличивая время ожидания между повторными попытками до максимального времени выдержки. Пример:
- Отправьте запрос к Google Forms API.
- Если запрос не удается выполнить, подождите 1 +
random_number_millisecondsи повторите попытку. - Если запрос не удается выполнить, подождите 2 +
random_number_millisecondsи повторите попытку. - Если запрос не удается выполнить, подождите 4 +
random_number_millisecondsи повторите попытку. - и так далее, до
maximum_backoffраз. - Продолжайте ждать и повторять попытки до достижения максимального количества попыток, но не увеличивайте период ожидания между попытками.
где:
- Время ожидания составляет
min(((2^n)+random_number_milliseconds), maximum_backoff), гдеnувеличивается на 1 для каждой итерации (запроса). random_number_milliseconds– случайное число миллисекунд,не превышающее 1000. Это позволяет избежать ситуаций, когда множество клиентов синхронизируются одновременно и отправляют запросы волнами. Значениеrandom_number_millisecondsпересчитывается после каждого повторного запроса.maximum_backoffобычно составляет 32 или 64 секунды. Подходящее значение зависит от конкретного случая.
Клиент может продолжать попытки после достижения времени maximum_backoff.
После этого увеличивать время задержки не нужно. Например, если клиент использует значение maximum_backoff, равное 64 секундам, то после достижения этого значения клиент может повторять попытку каждые 64 секунды. В какой-то момент клиенты должны прекратить попытки.
Время ожидания между повторными попытками и их количество зависят от вашего сценария использования и условий сети.
Цены
Стандартное использование Google Forms API предоставляется бесплатно. Превышение лимитов на запросы квоты будет оплачиваться через платежный аккаунт Google Cloud. Это изменение планируется ввести в 2026 году. Дополнительную информацию можно найти в статье Стандартизированная модель Google Workspace для инструментов и API агентов.
Как запросить увеличение квоты
В зависимости от особенностей использования ресурсов в проекте может возникнуть необходимость запросить корректировку квоты. Вызовы API, выполняемые сервисным аккаунтом, считаются вызовами, выполняемыми одним аккаунтом. Запрос на изменение квоты может быть отклонен. Для одобрения запросов на значительное увеличение квот может потребоваться больше времени.
Квоты могут различаться в зависимости от проекта. По мере того как вы будете все больше использовать Google Cloud, вам может потребоваться увеличить квоты. Если вы ожидаете значительного увеличения использования, вы можете заранее запросить корректировку квот на странице Quotas & System Limits (Квоты и системные ограничения) в консоли Google Cloud.
Дополнительную информацию можно найти в следующих ресурсах: