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 |