Лимиты на использование

Google Forms API – это общий сервис, поэтому мы применяем квоты и ограничения, чтобы обеспечить его справедливое использование всеми пользователями и защитить общую работоспособность системы Google Workspace.

Если вы превысите квоту, то, как правило, получите в ответ код статуса HTTP 429: Too many requests. В этом случае используйте алгоритм экспоненциальной выдержки и повторите попытку позже. Если вы не превышаете указанные ниже квоты на минуту, количество запросов в день не ограничено.

Примечание. Для отслеживания форм действуют дополнительные ограничения. Подробнее о том, как настроить и получать push-уведомления…

В таблице ниже приведены ограничения на запросы.

Квоты
Запросы на чтение
На проект в день Без ограничений
В минуту на проект 975
На пользователя в минуту на проект 390
Дорогие запросы на чтение

(Используется для запросов forms.responses.list.)

На проект в день Без ограничений
В минуту на проект 450
На пользователя в минуту на проект 180
Запросы на запись
На проект в день Без ограничений
В минуту на проект 375
На пользователя в минуту на проект 150

Как устранить ошибки, связанные с временными квотами

Для всех ошибок, связанных со временем (максимум N запросов за X минут), мы рекомендуем, чтобы ваш код перехватывал исключение и использовал усеченную экспоненциальную выдержку, чтобы ваши устройства не генерировали чрезмерную нагрузку.

Экспоненциальная выдержка – это стандартная стратегия обработки ошибок для сетевых приложений. Алгоритм экспоненциальной выдержки повторяет запросы, экспоненциально увеличивая время ожидания между ними до максимального значения. Если запросы по-прежнему не выполняются, важно, чтобы задержки между ними со временем увеличивались, пока запрос не будет выполнен.

Пример алгоритма

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

  1. Отправьте запрос к Google Forms API.
  2. Если запрос не удается выполнить, подождите 1 + random_number_milliseconds и повторите попытку.
  3. Если запрос не удается выполнить, подождите 2 + random_number_milliseconds и повторите попытку.
  4. Если запрос не удается выполнить, подождите 4 + random_number_milliseconds и повторите попытку.
  5. и так далее, до maximum_backoff раз.
  6. Продолжайте ждать и повторять попытки до достижения максимального количества попыток, но не увеличивайте период ожидания между попытками.

где:

  • Время ожидания составляет 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.

Дополнительную информацию можно найти в следующих ресурсах: