Limiti di utilizzo
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
L'API Gmail è soggetta a limiti di utilizzo che limitano la velocità con cui
possono essere chiamati i metodi dell'API. I limiti sono definiti in termini di unità
di quota , un'unità di misura astratta che rappresenta
l'utilizzo delle risorse di Gmail. Vengono applicati simultaneamente due limiti di utilizzo: un limite di utilizzo per progetto e un limite di utilizzo per utente. La
tabella seguente descrive in dettaglio questi limiti di utilizzo:
Tipo di limite di utilizzo
Limite
Motivo del superamento
Limite di frequenza per progetto
1.200.000 unità di quota al minuto
rateLimitExceeded
Limite di frequenza per utente
15.000 unità di quota per utente al minuto
userRateLimitExceeded
Nota: per informazioni sulla gestione degli errori relativi ai limiti, consulta Risolvere
gli errori . Utilizzo della quota per metodo
Il numero di unità di quota consumate da una richiesta varia a seconda del metodo chiamato. La seguente tabella descrive l'utilizzo delle unità di quota per metodo:
Metodo
Unità di quota
drafts.create10
drafts.delete10
drafts.get5
drafts.list5
drafts.send100
drafts.update15
getProfile1
history.list2
labels.create5
labels.delete5
labels.get1
labels.list1
labels.update5
messages.attachments.get5
messages.batchDelete50
messages.batchModify50
messages.delete10
messages.get5
messages.import25
messages.insert25
messages.list5
messages.modify5
messages.send100
messages.trash5
messages.untrash5
settings.delegates.create100
settings.delegates.delete5
settings.delegates.get1
settings.delegates.list1
settings.filters.create5
settings.filters.delete5
settings.filters.get1
settings.filters.list1
settings.forwardingAddresses.create100
settings.forwardingAddresses.delete5
settings.forwardingAddresses.get1
settings.forwardingAddresses.list1
settings.getAutoForwarding1
settings.getImap1
settings.getPop1
settings.getVacation1
settings.sendAs.create100
settings.sendAs.delete5
settings.sendAs.get1
settings.sendAs.list1
settings.sendAs.update100
settings.sendAs.verify100
settings.updateAutoForwarding5
settings.updateImap5
settings.updatePop100
settings.updateVacation5
stop50
threads.delete20
threads.get10
threads.list10
threads.modify10
threads.trash10
threads.untrash10
watch100
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0 , mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0 . Per ulteriori dettagli, consulta le norme del sito di Google Developers . Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[],[],null,["# Usage limits\n\nThe Gmail API is subject to usage limits which restrict the rate at which\nmethods of the API can be called. Limits are defined in terms of [quota\nunits](#per-method_quota_usage), an abstract unit of measurement representing\nGmail resource usage. There are two usage limits which are applied\nsimultaneously: a per project usage limit and a per user usage limit. The\nfollowing table details these usage limits:\n\n| Usage limit type | Limit | Exceeded reason |\n|------------------------|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|\n| Per project rate limit | 1,200,000 quota units per minute | [rateLimitExceeded](https://developers.google.com/workspace/gmail/api/guides/handle-errors#resolve_a_403_error_rate_limit_exceeded) |\n| Per user rate limit | 15,000 quota units per user per minute | [userRateLimitExceeded](https://developers.google.com/workspace/gmail/api/guides/handle-errors#resolve_a_403_error_user_rate_limit_exceeded) |\n\n| **Note:** For information on handling limit errors, refer to [Resolve\n| errors](/workspace/gmail/api/guides/handle-errors).\n\nPer-method quota usage\n----------------------\n\nThe number of quota units consumed by a request varies depending on the method\ncalled. The following table outlines the per-method quota unit usage:\n\n| Method | Quota Units |\n|---------------------------------------|-------------|\n| `drafts.create` | 10 |\n| `drafts.delete` | 10 |\n| `drafts.get` | 5 |\n| `drafts.list` | 5 |\n| `drafts.send` | 100 |\n| `drafts.update` | 15 |\n| `getProfile` | 1 |\n| `history.list` | 2 |\n| `labels.create` | 5 |\n| `labels.delete` | 5 |\n| `labels.get` | 1 |\n| `labels.list` | 1 |\n| `labels.update` | 5 |\n| `messages.attachments.get` | 5 |\n| `messages.batchDelete` | 50 |\n| `messages.batchModify` | 50 |\n| `messages.delete` | 10 |\n| `messages.get` | 5 |\n| `messages.import` | 25 |\n| `messages.insert` | 25 |\n| `messages.list` | 5 |\n| `messages.modify` | 5 |\n| `messages.send` | 100 |\n| `messages.trash` | 5 |\n| `messages.untrash` | 5 |\n| `settings.delegates.create` | 100 |\n| `settings.delegates.delete` | 5 |\n| `settings.delegates.get` | 1 |\n| `settings.delegates.list` | 1 |\n| `settings.filters.create` | 5 |\n| `settings.filters.delete` | 5 |\n| `settings.filters.get` | 1 |\n| `settings.filters.list` | 1 |\n| `settings.forwardingAddresses.create` | 100 |\n| `settings.forwardingAddresses.delete` | 5 |\n| `settings.forwardingAddresses.get` | 1 |\n| `settings.forwardingAddresses.list` | 1 |\n| `settings.getAutoForwarding` | 1 |\n| `settings.getImap` | 1 |\n| `settings.getPop` | 1 |\n| `settings.getVacation` | 1 |\n| `settings.sendAs.create` | 100 |\n| `settings.sendAs.delete` | 5 |\n| `settings.sendAs.get` | 1 |\n| `settings.sendAs.list` | 1 |\n| `settings.sendAs.update` | 100 |\n| `settings.sendAs.verify` | 100 |\n| `settings.updateAutoForwarding` | 5 |\n| `settings.updateImap` | 5 |\n| `settings.updatePop` | 100 |\n| `settings.updateVacation` | 5 |\n| `stop` | 50 |\n| `threads.delete` | 20 |\n| `threads.get` | 10 |\n| `threads.list` | 10 |\n| `threads.modify` | 10 |\n| `threads.trash` | 10 |\n| `threads.untrash` | 10 |\n| `watch` | 100 |"]]
