Limites de uso

A API Gmail está sujeita a limites de uso que restringem a taxa em que os métodos da API podem ser chamados. Os limites são definidos em termos de unidades de cota, uma unidade abstrata de medição que representa o uso de recursos do Gmail. Há dois limites de uso aplicados simultaneamente: um por projeto e outro por usuário. A tabela a seguir detalha esses limites de uso:

Tipo de limite de uso Limite Motivo do excesso
Limite de taxa por projeto 1.200.000 unidades de cota por minuto rateLimitExceeded
Limite de taxa por usuário 15.000 unidades de cota por usuário a cada minuto userRateLimitExceeded

Uso de cota por método

O número de unidades de cota consumidas por uma solicitação varia de acordo com o método chamado. A tabela a seguir descreve o uso da unidade de cota por método:

Método Unidades de cota
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