Limity wykorzystania
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Interfejs Gmail API podlega limitom użytkowania, które ograniczają częstotliwość wywoływania metod interfejsu API. Limity są określane w jednostkach limitu , czyli abstrakcyjnych jednostkach miary reprezentujących wykorzystanie zasobów Gmaila. Obowiązują 2 limity wykorzystania, które są stosowane jednocześnie: limit wykorzystania na projekt i limit wykorzystania na użytkownika. W tabeli poniżej znajdziesz szczegółowe informacje o tych limitach wykorzystania:
Typ limitu wykorzystania
Limit
Przyczyna przekroczenia
Limit liczby żądań według projektu
1 200 000 jednostek limitu na minutę
rateLimitExceeded
Limit na użytkownika
15 000 jednostek limitu na użytkownika na minutę
userRateLimitExceeded
Uwaga: informacje o rozwiązywaniu błędów związanych z limitami znajdziesz w artykule Rozwiązywanie błędów . Wykorzystanie limitu na metodę
Liczba jednostek limitu wykorzystanych przez żądanie zależy od wywołanej metody. W tabeli poniżej znajdziesz informacje o wykorzystaniu jednostek limitu w przypadku poszczególnych metod:
Metoda
Jednostki limitu
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
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0 , a fragmenty kodu są dostępne na licencji Apache 2.0 . Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers . Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-29 UTC.
[null,null,["Ostatnia aktualizacja: 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 |"]]
