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

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

Ограничения определяются в единицах квоты – абстрактных единицах измерения, представляющих использование ресурсов Google Диска.

Квоты Drive API

Применяются три типа квот:

  • В минуту на проект. Количество единиц квоты, которое может использовать ваш проект Google Cloud за одну минуту.

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

  • В день на проект. Максимальный объем исходящего трафика в байтах, который может быть передан в рамках облачного проекта Google Cloud за 24 часа без взимания платы.

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

Тип лимита на использование Ограничение
В минуту на проект 1 000 000 единиц квоты
На пользователя в минуту на проект 325 000 единиц квоты
На проект в день 1 ТБ

Если вы превысите квоту, то получите ответ с кодом статуса HTTP 403: User rate limit exceeded. Дополнительные проверки ограничения частоты запросов на сервере Диска также могут привести к ответу 429: Rate limit exceeded. В этом случае используйте алгоритм экспоненциальной выдержки и повторите попытку позже.

Суточный порог оплаты

Этот лимит на день на проект определяет максимальное количество единиц квоты, которое ваш облачный проект Google Cloud может использовать в течение 24 часов до взимания платы.

Если вы не превысите этот порог, то плата за использование взиматься не будет и в вашем аккаунте Google Cloud не будет выставлен счет. Полная информация об оплате будет предоставлена позже в 2026 году не менее чем за 90 дней до вступления изменений в силу.

Запросить увеличение этого лимита нельзя.

Ограничения приведены в таблице ниже.

Тип порогового значения Ограничение
На проект в день 400 000 000 единиц квоты

Дополнительную информацию можно найти в статье Стандартизированная модель Google Workspace для инструментов и API агентов.

Стоимость единиц квоты для каждого метода

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

Методы чтения (5 единиц квоты)

Метод
drive.about.get
drive.accessproposals.get
drive.apps.get
drive.approvals.get
drive.changes.get
drive.children.get
drive.comments.get
drive.drives.get
drive.files.get (without alt=media)
drive.parents.get
drive.permissions.get
drive.properties.get
drive.replies.get
drive.revisions.get (without alt=media)
drive.teamdrives.get

Методы List (100 единиц квоты)

Метод
drive.accessproposals.list
drive.apps.list
drive.changes.list, drive.changes.watch
drive.children.list
drive.comments.list
drive.drives.list
drive.files.list, drive.files.watch
drive.parents.list
drive.permissions.list
drive.properties.list
drive.replies.list
drive.revisions.list
drive.teamdrives.list

Методы редактирования (50 единиц квоты)

Метод
drive.approvals.decline
drive.children.delete, drive.children.insert
drive.comments.create, drive.comments.delete, drive.comments.insert, drive.comments.patch, drive.comments.update
drive.drives.create, drive.drives.delete, drive.drives.hide, drive.drives.insert, drive.drives.unhide, drive.drives.update
drive.files.copy, drive.files.create, drive.files.delete, drive.files.emptyTrash, drive.files.insert, drive.files.modifyLabels, drive.files.patch, drive.files.touch, drive.files.trash, drive.files.untrash, drive.files.update
drive.parents.delete, drive.parents.insert
drive.permissions.create, drive.permissions.delete, drive.permissions.insert, drive.permissions.patch, drive.permissions.update
drive.properties.delete, drive.properties.insert, drive.properties.patch, drive.properties.update
drive.replies.create, drive.replies.delete, drive.replies.insert, drive.replies.patch, drive.replies.update
drive.revisions.delete, drive.revisions.patch, drive.revisions.update
drive.teamdrives.create, drive.teamdrives.delete, drive.teamdrives.insert, drive.teamdrives.update

Методы скачивания (200 единиц квоты)

Метод
drive.files.download, drive.files.export, drive.files.get (with alt=media)
drive.revisions.get (with alt=media)

Другие методы (5 единиц квоты)

Метод
drive.changes.getStartPageToken
drive.channels.stop
drive.files.generateCseToken, drive.files.generateIds, drive.files.listLabels
drive.operations.get
drive.permissions.getIdForEmail

Дополнительные ограничения

При работе с Drive API действуют следующие ограничения:

  • Пользователи Google Workspace могут загружать не более 750 ГБ в день в раздел "Мой диск" и на все общие диски. Это ограничение также распространяется на копии.

  • Если указанный объем уже достигнут или пользователь загрузил файл размером более 750 ГБ, новые файлы нельзя загружать и копировать в течение 24 часов.

  • Максимальный размер файла, который могут загрузить пользователи, составляет 5 ТБ. Будет завершена загрузка только первого файла, приведшего к превышению ограничения. Максимальный размер файла, который пользователи могут скопировать, составляет 750 ГБ.

  • Уведомления, отправленные на адрес, указанный при открытии канала уведомлений, не учитываются в квоте. Однако вызовы методов changes.watch, channels.stop и files.watch учитываются в квоте.

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

  • В зависимости от типа аккаунта Google Workspace могут действовать дополнительные ограничения на использование пространства на Диске.

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

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

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

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

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

  1. Отправьте запрос к Google Drive 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 Drive API бесплатно. Превышение лимитов на запросы квоты будет оплачиваться через платежный аккаунт Google Cloud. Это изменение планируется ввести в 2026 году. Дополнительную информацию можно найти в статье Стандартизированная модель Google Workspace для инструментов агентов и API.

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

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

Квоты могут различаться в зависимости от проекта. По мере того как вы будете все больше использовать Google Cloud, вам может потребоваться увеличить квоты. Если вы ожидаете значительного увеличения использования, вы можете заранее запросить корректировку квот на странице Quotas & System Limits (Квоты и системные лимиты) в консоли Google Cloud.

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

Квоты MCP-сервера Диска

MCP-сервер Диска использует показатель распределения стоимости запросов. В таблицах ниже приведены сведения о стоимости запросов для каждого метода MCP-сервера Диска по разделам.

Квоты MCP для Диска

Применяются два типа квот:

  • В минуту на проект. Стоимость запросов для проекта Google Cloud за одну минуту.

  • В минуту на пользователя на проект. Это стоимость запросов к вашему облачному проекту Google Cloud за одну минуту, которую может использовать любой отдельный пользователь.

В таблице ниже приведены сведения об этих квотах.

Тип лимита на использование Ограничение
В минуту на проект 325 000
На пользователя в минуту на проект 1 000 000

Квоты набора инструментов MCP для Диска

В таблице ниже указана стоимость запросов для каждого набора инструментов drivemcp.googleapis.com.

Конечная точка Инструмент Стоимость запроса

/mcp/v1

copy_file

50

create_file

50

download_file_content

200

get_file_metadata

5

get_file_permissions

5

list_recent_files

100

read_file_content

200

search_files

100

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