Limites d'utilisation

L'API Gmail est soumise à des limites d'utilisation qui restreignent la fréquence à laquelle les méthodes de l'API peuvent être appelées. Les limites sont définies en unités de quota, une unité de mesure abstraite représentant l'utilisation des ressources Gmail. Deux limites d'utilisation s'appliquent simultanément : une limite d'utilisation par projet et une limite d'utilisation par utilisateur. Le tableau suivant détaille ces limites d'utilisation :

Type de limite d'utilisation Limite Motif de dépassement
Limite de débit par projet 1 200 000 unités de quota par minute rateLimitExceeded
Limite de débit par utilisateur 15 000 unités de quota par utilisateur et par minute userRateLimitExceeded

Utilisation du quota par méthode

Le nombre d'unités de quota consommées par une requête varie en fonction de la méthode appelée. Le tableau suivant indique l'utilisation des unités de quota par méthode :

Méthode Unités de quota
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