Kullanım sınırları
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Gmail API, API yöntemlerinin çağrılabileceği hızı kısıtlayan kullanım sınırlarına tabidir. Sınırlar, Gmail kaynak kullanımını temsil eden soyut bir ölçü birimi olan kota birimleri cinsinden tanımlanır. Aynı anda uygulanan iki kullanım sınırı vardır: proje başına kullanım sınırı ve kullanıcı başına kullanım sınırı. Aşağıdaki tabloda bu kullanım sınırları ayrıntılı olarak açıklanmaktadır:
Kullanım sınırı türü
Sınır
Aşma nedeni
Proje başına sıklık sınırı
Dakikada 1.200.000 kota birimi
rateLimitExceeded
Kullanıcı başına hız sınırı
Kullanıcı başına dakikada 15.000 kota birimi
userRateLimitExceeded
Not: Sınır hatalarını ele alma hakkında bilgi edinmek için Hataları çözme başlıklı makaleyi inceleyin. Yöntem başına kota kullanımı
Bir istek tarafından kullanılan kota birimi sayısı, çağrılan yönteme göre değişir. Aşağıdaki tabloda, yöntem başına kota birimi kullanımı özetlenmiştir:
Yöntem
Kota birimleri
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
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları 'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-29 UTC.
[null,null,["Son güncelleme tarihi: 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 |"]]
