Kullanım sınırları

Gmail API, API yöntemlerini çağırma hızını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.

Gmail API kotaları

Gmail API, iki tür kota uygular:

  • Proje başına dakika başına: Google Cloud projenizin bir dakikada kullanabileceği kota birimi sayısıdır.

  • Proje başına kullanıcı başına dakika başına: Bu, herhangi bir kullanıcının Cloud projenizde kullanabileceği kota birimi sayısıdır. Bu sınır, kullanımın kullanıcılarınız arasında adil bir şekilde dağıtılmasını sağlar.

Aşağıdaki tabloda bu sınırlar ayrıntılı olarak açıklanmıştır:

Kullanım sınırı türü Sınır
Proje başına dakikalık 1.200.000 kota birimi
Proje başına kullanıcı başına dakikalık 6.000 kota birimi

Sınır hatalarını ele alma hakkında bilgi için Hataları çözme bölümüne bakın.

Günlük faturalandırma eşiği

Proje başına günlük olarak belirlenen bu sınır, Google Cloud projenizin ücretlendirme uygulanmadan önce 24 saatlik bir süre içinde kullanabileceği maksimum kota birimi sayısını tanımlar.

Bu eşiğin altındaki kullanım için ek ücret alınmaz ve Google Cloud hesabınız faturalandırılmaz. Google, faturalandırmayla ilgili tüm ayrıntıları 2026'da paylaşacak ve değişiklikler geçerlilik kazanmadan en az 90 gün önce bildirimde bulunacak.

Bu günlük eşik sınırının artırılmasını talep edemezsiniz.

Aşağıdaki tabloda sınırla ilgili ayrıntılar verilmiştir:

Eşik sınırı türü Sınır
Proje başına günlük 80.000.000 kota birimi

Daha fazla bilgi için Temsilci araçları ve API'ler için Google Workspace standartlaştırılmış modeli başlıklı makaleyi inceleyin.

Yöntem başına kota kullanımı

Her isteğin tükettiği kota birimi sayısı, çağırdığınız yönteme ve sorgu parametrelerine göre değişir. Aşağıdaki tabloda, yöntem başına kota birimi kullanımı açıklanmaktadır:

Yöntem Kota birimleri
drafts.create 10
drafts.delete 10
drafts.get 20 (format; full, raw veya html olduğunda 60)
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 20
messages.batchDelete 50
messages.batchModify 50
messages.delete 10
messages.get 20 (format; full, raw veya html olduğunda 60)
messages.import 25
messages.insert 25
messages.list 5
messages.modify 5
messages.send 100
messages.trash 20
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 40 (format, full olduğunda 120)
threads.list 10
threads.modify 10
threads.trash 20
threads.untrash 10
watch 100

Gmail API'yi kullanırken e-posta iletisi başına 500 alıcı sınırı da vardır.

Zamana dayalı kota hatalarını çözme

Zamana dayalı tüm hatalar için (X dakikada en fazla N istek) kodunuzun istisnayı yakalamasını ve cihazlarınızın aşırı yük oluşturmamasını sağlamak için kesilmiş eksponansiyel geri yükleme kullanmasını öneririz.

Eksponansiyel geri yükleme, ağ uygulamaları için standart bir hata işleme stratejisidir. Eksponansiyel geri yükleme algoritması, istekler arasında eksponansiyel olarak artan bekleme süreleri kullanarak istekleri yeniden dener. Bu süre, maksimum geri yükleme süresine kadar artar. İstekler hâlâ başarısız oluyorsa istek başarılı olana kadar istekler arasındaki gecikme süresinin zaman içinde artması önemlidir.

Örnek algoritma

Eksponansiyel geri yükleme algoritması, istekleri eksponansiyel olarak yeniden dener ve yeniden denemeler arasındaki bekleme süresini maksimum geri yükleme süresine kadar artırır. Örneğin:

  1. Gmail API'ye istek gönderme
  2. İstek başarısız olursa 1 + random_number_milliseconds bekleyin ve isteği yeniden deneyin.
  3. İstek başarısız olursa 2 + random_number_milliseconds bekleyin ve isteği yeniden deneyin.
  4. İstek başarısız olursa 4 + random_number_milliseconds bekleyin ve isteği yeniden deneyin.
  5. Bu şekilde maximum_backoff kez devam eder.
  6. Maksimum deneme sayısına ulaşana kadar beklemeye ve yeniden denemeye devam edin ancak denemeler arasındaki bekleme süresini artırmayın.

Bu örnekte:

  • Bekleme süresi min(((2^n)+random_number_milliseconds), maximum_backoff) olup her iterasyon (istek) için n 1 artırılır.
  • random_number_milliseconds,1.000'den küçük veya 1.000'e eşit rastgele bir milisaniye sayısıdır. Bu sayede, birçok istemcinin bir durum nedeniyle senkronize edildiği ve hepsinin aynı anda yeniden deneme yaparak senkronize dalgalar halinde istek gönderdiği durumlar önlenir. random_number_milliseconds değeri, her yeniden deneme isteğinden sonra yeniden hesaplanır.
  • maximum_backoff genellikle 32 veya 64 saniyedir. Uygun değer, kullanım alanına bağlıdır.

İstemci, maximum_backoff süresine ulaştıktan sonra yeniden denemeye devam edebilir. Bu noktadan sonraki yeniden denemelerde bekleme süresinin artırılmasına gerek yoktur. Örneğin, bir istemci 64 saniyelik bir maximum_backoff süresi kullanıyorsa bu değere ulaştıktan sonra her 64 saniyede bir yeniden deneyebilir. Bir noktada, istemcilerin süresiz olarak yeniden denemesi engellenmelidir.

Yeniden denemeler arasındaki bekleme süresi ve yeniden deneme sayısı, kullanım alanınıza ve ağ koşullarınıza bağlıdır.

Fiyatlandırma

Gmail API'nin tüm standart kullanımları ek ücret ödemeden kullanılabilir. Kota istek sınırlarının aşılması durumunda 2026'nın ilerleyen dönemlerinde Google Cloud Faturalandırma Hesabınızdan ücret alınması planlanmaktadır. Daha fazla bilgi için Temsilci araçları ve API'ler için Google Workspace standartlaştırılmış modeli başlıklı makaleyi inceleyin.

Kota artışı isteme

Projenizin kaynak kullanımına bağlı olarak kota düzenlemesi talep edebilirsiniz. Bir hizmet hesabı tarafından yapılan API çağrılarının tek bir hesap kullandığı kabul edilir. Kota düzenlemesi başvurusunda bulunmak onay alacağınıza dair bir garanti teşkil etmez. Kota değerini önemli ölçüde artıracak kota ayarlama isteklerinin onaylanması daha uzun sürebilir.

Her projenin kotası aynı değildir. Zaman içinde Google Cloud'u daha fazla kullandıkça kota değerlerinizi artırmanız gerekebilir. Kullanımda kayda değer bir artış bekliyorsanız Google Cloud Console'daki Kotalar ve Sistem Sınırları sayfasından proaktif olarak kota düzenlemesi isteyebilirsiniz.

Daha fazla bilgi için aşağıdaki kaynaklara göz atın:

Gmail MCP sunucusu kotaları

Gmail MCP sunucusu, sorgu maliyeti tahsisi metriği kullanır. Aşağıdaki tablolarda, her Gmail MCP sunucu yönteminin sorgu maliyeti bölümlere göre ayrıntılı olarak açıklanmıştır:

Gmail MCP kotaları

Sunucu iki tür kota uygular:

  • Proje başına dakika başına: Bu, Cloud projenizin bir dakikalık sorgu maliyetidir.

  • Kullanıcı başına her projede bir dakika içinde gönderilen istek sayısı: Bu, belirli bir kullanıcının bir dakika içinde kullanabileceği Cloud projenizin sorgu maliyetidir.

Aşağıdaki tabloda bu kotalar ayrıntılı olarak açıklanmıştır:

Kullanım sınırı türü Sorgu maliyeti
Proje başına dakikalık 1.200.000
Proje başına kullanıcı başına dakikalık 6.000

Gmail MCP araç seti kotaları

Aşağıdaki tabloda, her bir gmailmcp.googleapis.com araç seti için sorgu maliyeti ayrıntılı olarak açıklanmaktadır:

Uç nokta Araç Sorgu maliyeti

/mcp/v1

create_draft

10

get_thread

40

label_message

10

label_thread

10

list_drafts

5

list_labels

1

search_threads

10

unlabel_message

10

unlabel_thread

10

Daha fazla bilgi için Gmail MCP API referansı'na bakın.