Лимиты на использование
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
На API Gmail распространяются ограничения на использование, которые ограничивают частоту вызова методов API. Эти ограничения определяются в единицах квоты — абстрактных единицах измерения, отражающих использование ресурсов Gmail. Существует два ограничения, которые применяются одновременно: ограничение на использование по проекту и ограничение на использование по пользователю. Эти ограничения подробно описаны в следующей таблице:
Тип ограничения использования Предел Причина превышения Ограничение по ставке за проект 1 200 000 единиц квоты в минуту rateLimitExceeded Ограничение скорости на пользователя 15 000 единиц квоты на пользователя в минуту userRateLimitExceeded
Примечание: Информацию об обработке ошибок пределов см. в разделе Устранение ошибок . Использование квоты по методам Количество единиц квоты, потребляемых запросом, зависит от вызываемого метода. В следующей таблице показано использование единиц квоты для каждого метода:
Метод Единицы квоты drafts.create 10 drafts.delete 10 drafts.get 5 drafts.list 5 drafts.send 100 drafts.update 15 getProfile 1 history.list 2 labels.create 5 labels.delete 5 labels.get 1 labels.list 1 labels.update 5 messages.attachments.get 5 messages.batchDelete 50 messages.batchModify 50 messages.delete 10 messages.get 5 messages.import 25 messages.insert 25 messages.list 5 messages.modify 5 messages.send 100 messages.trash 5 messages.untrash 5 settings.delegates.create 100 settings.delegates.delete 5 settings.delegates.get 1 settings.delegates.list 1 settings.filters.create 5 settings.filters.delete 5 settings.filters.get 1 settings.filters.list 1 settings.forwardingAddresses.create 100 settings.forwardingAddresses.delete 5 settings.forwardingAddresses.get 1 settings.forwardingAddresses.list 1 settings.getAutoForwarding 1 settings.getImap 1 settings.getPop 1 settings.getVacation 1 settings.sendAs.create 100 settings.sendAs.delete 5 settings.sendAs.get 1 settings.sendAs.list 1 settings.sendAs.update 100 settings.sendAs.verify 100 settings.updateAutoForwarding 5 settings.updateImap 5 settings.updatePop 100 settings.updateVacation 5 stop 50 threads.delete 20 threads.get 10 threads.list 10 threads.modify 10 threads.trash 10 threads.untrash 10 watch 100
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0" , а примеры кода – по лицензии Apache 2.0 . Подробнее об этом написано в правилах сайта . Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[],[],null,["# Usage limits\n\nThe Gmail API is subject to usage limits which restrict the rate at which\nmethods of the API can be called. Limits are defined in terms of [quota\nunits](#per-method_quota_usage), an abstract unit of measurement representing\nGmail resource usage. There are two usage limits which are applied\nsimultaneously: a per project usage limit and a per user usage limit. The\nfollowing table details these usage limits:\n\n| Usage limit type | Limit | Exceeded reason |\n|------------------------|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|\n| Per project rate limit | 1,200,000 quota units per minute | [rateLimitExceeded](https://developers.google.com/workspace/gmail/api/guides/handle-errors#resolve_a_403_error_rate_limit_exceeded) |\n| Per user rate limit | 15,000 quota units per user per minute | [userRateLimitExceeded](https://developers.google.com/workspace/gmail/api/guides/handle-errors#resolve_a_403_error_user_rate_limit_exceeded) |\n\n| **Note:** For information on handling limit errors, refer to [Resolve\n| errors](/workspace/gmail/api/guides/handle-errors).\n\nPer-method quota usage\n----------------------\n\nThe number of quota units consumed by a request varies depending on the method\ncalled. The following table outlines the per-method quota unit usage:\n\n| Method | Quota Units |\n|---------------------------------------|-------------|\n| `drafts.create` | 10 |\n| `drafts.delete` | 10 |\n| `drafts.get` | 5 |\n| `drafts.list` | 5 |\n| `drafts.send` | 100 |\n| `drafts.update` | 15 |\n| `getProfile` | 1 |\n| `history.list` | 2 |\n| `labels.create` | 5 |\n| `labels.delete` | 5 |\n| `labels.get` | 1 |\n| `labels.list` | 1 |\n| `labels.update` | 5 |\n| `messages.attachments.get` | 5 |\n| `messages.batchDelete` | 50 |\n| `messages.batchModify` | 50 |\n| `messages.delete` | 10 |\n| `messages.get` | 5 |\n| `messages.import` | 25 |\n| `messages.insert` | 25 |\n| `messages.list` | 5 |\n| `messages.modify` | 5 |\n| `messages.send` | 100 |\n| `messages.trash` | 5 |\n| `messages.untrash` | 5 |\n| `settings.delegates.create` | 100 |\n| `settings.delegates.delete` | 5 |\n| `settings.delegates.get` | 1 |\n| `settings.delegates.list` | 1 |\n| `settings.filters.create` | 5 |\n| `settings.filters.delete` | 5 |\n| `settings.filters.get` | 1 |\n| `settings.filters.list` | 1 |\n| `settings.forwardingAddresses.create` | 100 |\n| `settings.forwardingAddresses.delete` | 5 |\n| `settings.forwardingAddresses.get` | 1 |\n| `settings.forwardingAddresses.list` | 1 |\n| `settings.getAutoForwarding` | 1 |\n| `settings.getImap` | 1 |\n| `settings.getPop` | 1 |\n| `settings.getVacation` | 1 |\n| `settings.sendAs.create` | 100 |\n| `settings.sendAs.delete` | 5 |\n| `settings.sendAs.get` | 1 |\n| `settings.sendAs.list` | 1 |\n| `settings.sendAs.update` | 100 |\n| `settings.sendAs.verify` | 100 |\n| `settings.updateAutoForwarding` | 5 |\n| `settings.updateImap` | 5 |\n| `settings.updatePop` | 100 |\n| `settings.updateVacation` | 5 |\n| `stop` | 50 |\n| `threads.delete` | 20 |\n| `threads.get` | 10 |\n| `threads.list` | 10 |\n| `threads.modify` | 10 |\n| `threads.trash` | 10 |\n| `threads.untrash` | 10 |\n| `watch` | 100 |"]]
