Google Workspace Events API ortak bir hizmet olduğundan tüm kullanıcılar tarafından adil kullanıldığından emin olmak 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. Google Workspace Events API arka ucundaki ek hız sınırı kontrolleri de aynı hata yanıtını oluşturabilir. Bu hata oluşursa üstel geri çekilme 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ünlük gönderebileceğiniz istek sayısında sınırlama yoktur.
Proje başına kotalar
Proje başına kotalar, bir Google Cloud projesinde sorgu hızını sınırlar. Bu nedenle, her kota için belirtilen Google Workspace Events API yöntemlerini çağıran tek bir uygulama için geçerli olur.
Aşağıdaki tabloda proje başına sorgu sınırları gösterilmiştir. Bu sınırları Google Cloud Console'daki Kotalar sayfasında da bulabilirsiniz.
Proje Başına Kota |
Google Workspace Events API yöntemleri |
Sınır |
|---|---|---|
Dakika başına yazma sayısı |
|
600 |
Kullanıcı başına dakikada yazma sayısı |
|
100 |
Dakika başına okuma sayısı |
|
600 |
Kullanıcı başına dakikada okuma sayısı |
|
100 |
Zamana dayalı kota hatalarını çözme
Tüm zamana dayalı hatalar için (X dakikada en fazla N istek) kodunuzun istisnayı yakalamasını ve cihazlarınızın aşırı yük oluşturmaması için kısaltılmış bir üstel geri yükleme kullanmasını öneririz.
Üstel geri yükleme, ağ uygulamaları için standart bir hata işleme stratejisidir. Üstel geri yükleme algoritması, istekler arasında katlanarak artan bekleme sürelerini kullanarak maksimum geri yükleme süresine kadar istekleri yeniden dener. İstekler yine de başarısız olursa istekler arasındaki gecikmelerin, istek başarılı olana kadar zaman içinde artması önemlidir.
Örnek algoritma
Üstel geri yükleme algoritması, istekleri katlanarak yeniden dener ve yeniden denemeler arasındaki bekleme süresini maksimum geri yükleme süresine kadar artırır. Örneğin:
- Google Workspace Events API'ye istekte bulunun.
- İ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 en fazla
maximum_backoffdefa girebilirsiniz. - Beklemeye devam edip maksimum deneme sayısına kadar tekrar deneyin. Ancak yeniden denemeler arasındaki bekleme süresini uzatmayın.
Bu örnekte:
- Bekleme süresi
min(((2^n)+random_number_milliseconds), maximum_backoff)şeklindedir venher yineleme (istek) için 1 artar. random_number_milliseconds,1.000'den küçük veya 1.000'e eşit olan rastgele bir milisaniye sayısıdır. Bu, çok sayıda istemcinin bir durumla senkronize edildiği ve tüm istemcilerin aynı anda yeniden deneme yaptığı durumlardan ve isteklerin senkronize dalgalar halinde gönderilmesinden kaçınmaya yardımcı olur.random_number_millisecondsdeğ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 sonra yapılan yeniden denemelerin geri yükleme süresini artırmaya devam etmesi gerekmez. Örneğin, bir istemci 64 saniyelik bir maximum_backoff süresi kullanırsa bu değere ulaştıktan sonra her 64 saniyede bir yeniden deneyebilir. Bir noktada istemcilerin yeniden denemesi süresiz olarak engellenmelidir.
Yeniden deneme sayısı ile yeniden deneme sayısı arasındaki bekleme süresi, kullanım alanınıza ve ağ koşullarınıza bağlıdır.
Proje başına kota artışı isteyin
Projenizin kaynak kullanımına bağlı olarak kota artışı talep edebilirsiniz. Bir hizmet hesabından yapılan API çağrıları, tek bir hesap kullanıyor olarak kabul edilir. Kota artışı için başvurmak, onay alacağınızı garanti etmez. Büyük kota artışlarının onaylanması daha uzun sürebilir.
Her projenin kotası aynı değildir. Google Cloud'u zaman içinde gitgide daha fazla kullandığınız için kotalarınızın artması gerekebilir. Kullanımın önemli oranda artacağını düşünüyorsanız Google Cloud Console'daki Kotalar sayfasından, önlem amaçlı olarak kotaların ayarlanmasını isteyebilirsiniz.
Daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın: