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

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

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

К методам Chat API могут применяться квоты нескольких типов: на проект, на чат-группу и на пользователя.

Квоты на проект

Квоты на проект ограничивают частоту запросов для проекта Google Cloud и, следовательно, применяются к одному приложению Chat, вызывающему указанные методы Chat API для каждой квоты.

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

Квота на проект

Методы Chat API

Ограничение (за 60 секунд)

Запись сообщений в минуту

spaces.messages.create

spaces.messages.patch

spaces.messages.delete

3000

Количество прочитанных сообщений в минуту

spaces.messages.get

spaces.messages.list

3000

Поисковые запросы по сообщениям в минуту

spaces.messages.search

300

Количество записей в минуту

spaces.members.create

spaces.members.delete

300

Количество операций чтения в минуту для Membership API

spaces.members.get

spaces.members.list

3000

Записи в чат-группе в минуту

spaces.setup

spaces.create

spaces.patch

spaces.delete

60

Количество операций чтения в минуту для чат-группы

spaces.get

spaces.list

spaces.findDirectMessage

spaces.search

3000

Количество операций чтения при поиске чат-групп в минуту (без прав администратора)

spaces.search

300

Записи прикрепленных файлов в минуту

media.upload

600

Количество чтений прикрепленных файлов в минуту

spaces.messages.attachments.get

media.download

3000

Количество реакций в минуту

spaces.messages.reactions.create

spaces.messages.reactions.delete

600

Количество прочитанных реакций в минуту

spaces.messages.reactions.list

3000

Записи CustomEmoji в минуту

customEmojis.create

customEmojis.delete

600

Количество операций чтения CustomEmoji в минуту

customEmojis.get

customEmojis.list

3000

Записи в раздел в минуту

users.sections.create

users.sections.delete

users.sections.patch

users.sections.position

users.sections.items.move

600

Количество прочтений раздела в минуту

users.sections.list

users.sections.items.list

3000

Количество запросов на чтение данных о доступности в минуту

users.availability.get

3000

Записи о доступности в минуту

users.availability.update

users.availability.markAsActive

users.availability.markAsAway

users.availability.markAsDoNotDisturb

3000

Количество записей статуса прочтения в минуту

users.spaces.updateSpaceReadState

users.spaces.threads.updateThreadReadState

3000

Количество операций чтения состояния в минуту

users.spaces.getSpaceReadState

users.spaces.threads.getThreadReadState

3000

Квоты на чат-группу

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

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

Квота на чат-группу

Методы Chat API

Ограничение (в секунду)

Количество операций чтения в секунду

media.download

spaces.get

spaces.members.get

spaces.members.list

spaces.messages.get

spaces.messages.list

spaces.messages.attachments.get

spaces.messages.reactions.list

15

Записей в секунду

media.upload

spaces.delete

spaces.patch

spaces.messages.create (Для входящих вебхуков действуют дополнительные ограничения.)

spaces.messages.delete

spaces.messages.patch

spaces.messages.reactions.delete

1

Количество операций записи в секунду при создании реакции

spaces.messages.reactions.create

5

Запись сообщений в секунду при импорте данных в Google Chat

spaces.messages.create

10

Квоты на пользователя

Квоты на пользователя ограничивают частоту запросов для пользователя Google Chat. Запросы относятся ко всем приложениям Chat, которые вызывают метод Chat API от имени пользователя (с помощью аутентификации пользователя).

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

Квота на пользователя

Методы Chat API

Ограничение (в секунду)

Количество операций записи CustomEmoji в секунду

customEmojis.create

customEmojis.delete

1

Количество операций чтения CustomEmoji в секунду

customEmojis.get

customEmojis.list

15

Записей в секунду

users.sections.create

users.sections.delete

users.sections.patch

users.sections.position

users.sections.items.move

users.availability.update

users.availability.markAsActive

users.availability.markAsAway

users.availability.markAsDoNotDisturb

1

Количество операций чтения в секунду

users.sections.list

users.sections.items.list

users.availability.get

15

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

Высокий трафик API, направленный на одно и то же пространство, может активировать дополнительные внутренние ограничения, которые не видны на странице Квоты.

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

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

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

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

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

  1. Отправьте запрос к Google Chat 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 секунды. В какой-то момент клиенты должны прекратить попытки.

Время ожидания между повторными попытками и их количество зависят от вашего сценария использования и условий сети.

Как запросить увеличение квоты для проекта

В зависимости от особенностей использования ресурсов в проекте может возникнуть необходимость запросить корректировку квоты. Вызовы 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

list_messages

1

search_conversations

10

search_messages

10

send_message

10

Дополнительную информацию можно найти в справочнике по Chat MCP API.