Kullanım sınırları

Google Chat API paylaşılan bir hizmet olduğundan, tüm kullanıcılar tarafından adil bir şekilde kullanılmasını sağlamak ve Google Workspace'in genel performansını korumak için kotalar ve sınırlamalar uygularız.

Bir kotayı aşarsanız 429: Too many requests HTTP durum kodu yanıtı alırsınız. Chat arka ucundaki ek sıklık sınırlaması kontrolleri de aynı hata yanıtını oluşturabilir. Bu hata oluşursa eksponansiyel geri yükleme algoritması kullanmanız ve daha sonra tekrar denemeniz gerekir. Aşağıdaki tablolarda listelenen dakika başına kotaları aşmadığınız sürece, günde yapabileceğiniz istek sayısında bir sınır yoktur.

Chat API yöntemleri için birden fazla kota türü geçerli olabilir: proje başına, alan başına ve kullanıcı başına kotalar.

Proje başına kotalar

Proje başına kotalar, bir Google Cloud projesinin sorgu hızını sınırlar. Bu nedenle, her kota için belirtilen Chat API yöntemlerini çağıran tek bir Chat uygulaması için geçerlidir.

Aşağıdaki tabloda, proje başına sorgu sınırları ayrıntılı olarak açıklanmaktadır. Bu sınırları Kotalar sayfasında da bulabilirsiniz.

Proje başına kota

Chat API yöntemleri

Sınır (60 saniyede bir)

Dakika başına mesaj yazma sayısı

spaces.messages.create

spaces.messages.patch

spaces.messages.delete

3000

Dakika başına mesaj okuma sayısı

spaces.messages.get

spaces.messages.list

3000

Dakika başına mesaj araması sayısı

spaces.messages.search

300

Dakika başına üyelik yazma sayısı

spaces.members.create

spaces.members.delete

300

Dakika başına üyelik okuma sayısı

spaces.members.get

spaces.members.list

3000

Dakika başına alan yazma sayısı

spaces.setup

spaces.create

spaces.patch

spaces.delete

60

Dakika başına alan okuma sayısı

spaces.get

spaces.list

spaces.findDirectMessage

spaces.search

3000

Dakika başına alan arama okuma sayısı (yönetici ayrıcalıkları olmadan)

spaces.search

300

Dakika başına ek yazma sayısı

media.upload

600

Dakika başına ek okuma sayısı

spaces.messages.attachments.get

media.download

3000

Dakika başına tepki yazma sayısı

spaces.messages.reactions.create

spaces.messages.reactions.delete

600

Dakika başına tepki okuma sayısı

spaces.messages.reactions.list

3000

Dakika başına CustomEmoji yazma sayısı

customEmojis.create

customEmojis.delete

600

Dakika başına CustomEmoji okuma sayısı

customEmojis.get

customEmojis.list

3000

Dakika başına bölüm yazma sayısı

users.sections.create

users.sections.delete

users.sections.patch

users.sections.position

users.sections.items.move

600

Dakika başına bölüm okuma sayısı

users.sections.list

users.sections.items.list

3000

Dakika başına müsaitlik okuma sayısı

users.availability.get

3000

Dakika başına müsaitlik yazma sayısı

users.availability.update

users.availability.markAsActive

users.availability.markAsAway

users.availability.markAsDoNotDisturb

3000

Dakika başına okuma durumu yazma sayısı

users.spaces.updateSpaceReadState

users.spaces.threads.updateThreadReadState

3000

Dakika başına okuma durumu okuma sayısı

users.spaces.getSpaceReadState

users.spaces.threads.getThreadReadState

3000

Alan başına kotalar

Alan başına kotalar, belirli bir alandaki sorgu sayısını sınırlar ve her kota için listelenen Chat API yöntemlerini çağıran, bu alanda etkin olan tüm Chat uygulamaları arasında paylaşılır.

Aşağıdaki tabloda, alan başına sorgu sınırları ayrıntılı olarak açıklanmaktadır:

Alan başına kota

Chat API yöntemleri

Sınır (saniye başına)

Saniye başına okuma sayısı

media.download

spaces.get

spaces.members.get

spaces.members.list

spaces.messages.get

spaces.messages.list

spaces.messages.attachments.get

spaces.messages.reactions.list

15

Saniyedeki yazma sayısı

media.upload

spaces.delete

spaces.patch

spaces.messages.create (Gelen webhook'lar için ek sınırlar geçerlidir.)

spaces.messages.delete

spaces.messages.patch

spaces.messages.reactions.delete

1

Saniye başına tepki oluşturma yazma sayısı

spaces.messages.reactions.create

5

Google Chat'e veri aktarırken saniye başına mesaj yazma sayısı

spaces.messages.create

10

Kullanıcı başına kotalar

Kullanıcı başına kotalar, bir Google Chat kullanıcısının sorgu hızını sınırlar. Sorgular, bir kullanıcı adına (kullanıcı kimlik doğrulaması kullanarak) Chat API yöntemini çağıran tüm Chat uygulamaları için geçerlidir.

Aşağıdaki tabloda kullanıcı başına sorgu sınırları ayrıntılı olarak açıklanmaktadır:

Kullanıcı Başına Kota

Chat API yöntemleri

Sınır (saniye başına)

Saniyede CustomEmoji yazma sayısı

customEmojis.create

customEmojis.delete

1

Saniyede CustomEmoji okuma sayısı

customEmojis.get

customEmojis.list

15

Saniyedeki yazma sayısı

users.sections.create

users.sections.delete

users.sections.patch

users.sections.position

users.sections.items.move

users.availability.update

users.availability.markAsActive

users.availability.markAsAway

users.availability.markAsDoNotDisturb

1

Saniyedeki okuma sayısı

users.sections.list

users.sections.items.list

users.availability.get

15

Ek kullanım sınırları

Aynı alanı hedefleyen yüksek API trafiği, Kotalar sayfasında görünmeyen ek dahili sınırları tetikleyebilir.

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 istekler arasındaki gecikme süresinin, istek başarılı olana kadar 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. Google Chat 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 n her iterasyon (istek) için 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.

Proje başına kota artışı isteme

Projenizin kaynak kullanımına bağlı olarak kota düzenlemesi isteğinde bulunabilirsiniz. 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:

Chat MCP sunucusu kotaları

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

Chat MCP kotaları

İki tür kota uygulanır:

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

  • Kullanıcı başına her projede bir dakika içinde gönderilen istek sayısı: Bu, herhangi bir kullanıcının bir dakika içinde kullanabileceği Google 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 3.000
Proje başına kullanıcı başına dakikalık 300

Chat MCP araç seti kotaları

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

Uç nokta

Araç

Sorgu maliyeti

/mcp/v1

list_messages

1

search_conversations

10

search_messages

10

send_message

10

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