Für die Gmail API gelten Nutzungslimits, die die Häufigkeit einschränken, mit der Methoden der API aufgerufen werden können. Limits werden in Kontingenteinheiten definiert, einer abstrakten Maßeinheit für die Ressourcennutzung in Gmail. Es gibt zwei Nutzungslimits, die gleichzeitig angewendet werden: ein Nutzungslimit pro Projekt und ein Nutzungslimit pro Nutzer. In der folgenden Tabelle sind diese Nutzungslimits aufgeführt:
| Art des Nutzungslimits | Limit | Grund für die Überschreitung |
|---|---|---|
| Ratenlimit pro Projekt | 1.200.000 Kontingenteinheiten pro Minute | rateLimitExceeded |
| Ratenbegrenzung pro Nutzer | 15.000 Kontingenteinheiten pro Nutzer und Minute | userRateLimitExceeded |
Kontingentnutzung pro Methode
Die Anzahl der Kontingenteinheiten, die für eine Anfrage verbraucht werden, hängt von der aufgerufenen Methode ab. In der folgenden Tabelle ist die Nutzung der Kontingenteinheit pro Methode aufgeführt:
| Methode | Kontingenteinheiten |
|---|---|
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 |