На API Gmail распространяются ограничения на использование, которые ограничивают скорость вызова методов API. Ограничения определяются в единицах квоты — абстрактной единице измерения, отражающей использование ресурсов Gmail. Существует два лимита использования, которые применяются одновременно: лимит использования на проект и лимит использования на пользователя. В следующей таблице подробно описаны ограничения на использование:
| Тип ограничения использования | Лимит | Причина превышения |
|---|---|---|
| Ограничение ставки по проекту | 1 200 000 единиц квоты в минуту | Ограничение скоростиПревышено |
| Ограничение скорости на пользователя | 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.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 |