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ı |
|
3000 |
Dakika başına mesaj okuma sayısı |
|
3000 |
Dakika başına mesaj araması sayısı |
|
300 |
Dakika başına üyelik yazma sayısı |
|
300 |
Dakika başına üyelik okuma sayısı |
|
3000 |
Dakika başına alan yazma sayısı |
|
60 |
Dakika başına alan okuma sayısı |
|
3000 |
Dakika başına alan arama okuma sayısı (yönetici ayrıcalıkları olmadan) |
|
300 |
Dakika başına ek yazma sayısı |
|
600 |
Dakika başına ek okuma sayısı |
|
3000 |
Dakika başına tepki yazma sayısı |
|
600 |
Dakika başına tepki okuma sayısı |
|
3000 |
Dakika başına CustomEmoji yazma sayısı |
|
600 |
Dakika başına CustomEmoji okuma sayısı |
|
3000 |
Dakika başına bölüm yazma sayısı |
|
600 |
Dakika başına bölüm okuma sayısı |
|
3000 |
Dakika başına müsaitlik okuma sayısı |
|
3000 |
Dakika başına müsaitlik yazma sayısı |
|
3000 |
Dakika başına okuma durumu yazma sayısı |
|
3000 |
Dakika başına okuma durumu okuma sayısı |
|
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ı |
|
15 |
Saniyedeki yazma sayısı |
|
1 |
Saniye başına tepki oluşturma yazma sayısı |
|
5 |
Google Chat'e veri aktarırken saniye başına mesaj yazma sayısı |
|
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ı |
|
1 |
Saniyede CustomEmoji okuma sayısı |
|
15 |
Saniyedeki yazma sayısı |
|
1 |
Saniyedeki okuma sayısı |
|
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:
- Google Chat API'ye istek gönderme
- İstek başarısız olursa 1 +
random_number_millisecondsbekleyin ve isteği yeniden deneyin. - İstek başarısız olursa 2 +
random_number_millisecondsbekleyin ve isteği yeniden deneyin. - İstek başarısız olursa 4 +
random_number_millisecondsbekleyin ve isteği yeniden deneyin. - Bu şekilde
maximum_backoffkez devam eder. - 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)olupnher 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_millisecondsdeğeri, her yeniden deneme isteğinden sonra yeniden hesaplanır.maximum_backoffgenellikle 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:
- Kota ayarlamaları hakkında
- Kota kullanımınızı ve sınırlarınızı görüntüleme
- Kota sınırını yükseltme isteğinde bulunma
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 |
|
1 |
|
10 |
|
|
10 |
|
|
10 |
Daha fazla bilgi için Chat MCP API referansı'na bakın.