Google Chat API – это общий сервис, поэтому мы применяем квоты и ограничения, чтобы обеспечить его справедливое использование всеми пользователями и защитить общую производительность Google Workspace.
Если вы превысите квоту, то получите ответ с кодом статуса HTTP 429: Too many requests. Дополнительные проверки ограничения частоты запросов на сервере Chat также могут привести к такому ответу. Если вы столкнулись с этой ошибкой, используйте алгоритм экспоненциальной выдержки и повторите попытку позже. Если вы не превышаете квоты на количество запросов в минуту, указанные в таблицах ниже, то можете отправлять сколько угодно запросов в день.
К методам Chat API могут применяться квоты нескольких типов: на проект, на чат-группу и на пользователя.
Квоты на проект
Квоты на проект ограничивают частоту запросов для проекта Google Cloud и, следовательно, применяются к одному приложению Chat, вызывающему указанные методы Chat API для каждой квоты.
В таблице ниже приведены ограничения на количество запросов в проекте. Эти ограничения также можно найти на странице Квоты.
Квота на проект |
Методы Chat API |
Ограничение (за 60 секунд) |
|---|---|---|
Запись сообщений в минуту |
|
3000 |
Количество прочитанных сообщений в минуту |
|
3000 |
Поисковые запросы по сообщениям в минуту |
|
300 |
Количество записей в минуту |
|
300 |
Количество операций чтения в минуту для Membership API |
|
3000 |
Записи в чат-группе в минуту |
|
60 |
Количество операций чтения в минуту для чат-группы |
|
3000 |
Количество операций чтения при поиске чат-групп в минуту (без прав администратора) |
|
300 |
Записи прикрепленных файлов в минуту |
|
600 |
Количество чтений прикрепленных файлов в минуту |
|
3000 |
Количество реакций в минуту |
|
600 |
Количество прочитанных реакций в минуту |
|
3000 |
Записи CustomEmoji в минуту |
|
600 |
Количество операций чтения CustomEmoji в минуту |
|
3000 |
Записи в раздел в минуту |
|
600 |
Количество прочтений раздела в минуту |
|
3000 |
Количество запросов на чтение данных о доступности в минуту |
|
3000 |
Записи о доступности в минуту |
|
3000 |
Количество записей статуса прочтения в минуту |
|
3000 |
Количество операций чтения состояния в минуту |
|
3000 |
Квоты на чат-группу
Квоты на чат-группу ограничивают частоту запросов в определенной чат-группе и распределяются между всеми приложениями Chat, работающими в этой чат-группе и вызывающими перечисленные методы Chat API для каждой квоты.
В таблице ниже приведены ограничения на количество запросов для каждого чат-пространства.
Квота на чат-группу |
Методы Chat API |
Ограничение (в секунду) |
|---|---|---|
Количество операций чтения в секунду |
|
15 |
Записей в секунду |
|
1 |
Количество операций записи в секунду при создании реакции |
|
5 |
Запись сообщений в секунду при импорте данных в Google Chat |
|
10 |
Квоты на пользователя
Квоты на пользователя ограничивают частоту запросов для пользователя Google Chat. Запросы относятся ко всем приложениям Chat, которые вызывают метод Chat API от имени пользователя (с помощью аутентификации пользователя).
В таблице ниже приведены ограничения на количество запросов для каждого пользователя.
Квота на пользователя |
Методы Chat API |
Ограничение (в секунду) |
|---|---|---|
Количество операций записи CustomEmoji в секунду |
|
1 |
Количество операций чтения CustomEmoji в секунду |
|
15 |
Записей в секунду |
|
1 |
Количество операций чтения в секунду |
|
15 |
Дополнительные лимиты на использование
Высокий трафик API, направленный на одно и то же пространство, может активировать дополнительные внутренние ограничения, которые не видны на странице Квоты.
Как устранить ошибки, связанные с временными квотами
Для всех ошибок, связанных со временем (максимум N запросов за X минут), мы рекомендуем, чтобы ваш код перехватывал исключение и использовал усеченную экспоненциальную выдержку, чтобы ваши устройства не генерировали чрезмерную нагрузку.
Экспоненциальная выдержка – это стандартная стратегия обработки ошибок для сетевых приложений. Алгоритм экспоненциальной выдержки повторяет запросы, экспоненциально увеличивая время ожидания между ними до максимального значения. Если запросы по-прежнему не выполняются, важно, чтобы задержки между ними со временем увеличивались, пока запрос не будет выполнен.
Пример алгоритма
Алгоритм экспоненциальной выдержки повторяет запросы экспоненциально, увеличивая время ожидания между повторными попытками до максимального времени выдержки. Пример:
- Отправьте запрос к Google Chat 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 секунды. В какой-то момент клиенты должны прекратить попытки.
Время ожидания между повторными попытками и их количество зависят от вашего сценария использования и условий сети.
Как запросить увеличение квоты для проекта
В зависимости от особенностей использования ресурсов в проекте может возникнуть необходимость запросить корректировку квоты. Вызовы API, выполняемые сервисным аккаунтом, считаются вызовами, выполняемыми одним аккаунтом. Запрос на изменение квоты может быть отклонен. Для одобрения запросов на значительное увеличение квот может потребоваться больше времени.
Квоты для разных проектов могут различаться. По мере того как вы будете все больше использовать Google Cloud, вам может потребоваться увеличить квоты. Если вы ожидаете значительного увеличения использования, вы можете заранее запросить корректировку квот на странице Quotas & System Limits (Квоты и системные ограничения) в консоли Google Cloud.
Дополнительную информацию можно найти в следующих ресурсах:
Квоты MCP-сервера Chat
MCP-сервер Chat использует показатель распределения стоимости запросов. В таблицах ниже приведены сведения о стоимости запросов для каждого метода MCP-сервера Chat по разделам:
Квоты MCP для Chat
Применяются два типа квот:
В минуту на облачный проект. Стоимость запросов к облачному проекту Google Cloud за одну минуту.
В минуту на пользователя на проект. Это стоимость запросов к вашему облачному проекту Google Cloud за одну минуту, которую может использовать любой конкретный пользователь.
В таблице ниже приведены сведения об этих квотах.
| Тип лимита на использование | Стоимость запроса |
|---|---|
| В минуту на проект | 3000 |
| На пользователя в минуту на проект | 300 |
Квоты на набор инструментов MCP для Chat
В таблице ниже указана стоимость запроса для каждого набора инструментов chatmcp.googleapis.com.
Конечная точка |
Инструмент |
Стоимость запроса |
|---|---|---|
/mcp/v1 |
|
1 |
|
10 |
|
|
10 |
|
|
10 |
Дополнительную информацию можно найти в справочнике по Chat MCP API.