На 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 |