Google Workspace Events 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.
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 meydana gelirse üsselik geri çekilme algoritması kullanıp daha sonra tekrar denemeniz gerekir. Aşağıdaki tablolarda listelenen dakika başına kotalar dahilinde kaldığınızda günlük olarak gönderebileceğiniz istek sayısı sınırsızdır.
Proje başına kotalar
Proje başına kotalar, bir Google Cloud projesinin sorgu hızını sınırlandırır ve bu nedenle her kota için belirtilen Google Workspace Events API yöntemlerini çağıran tek bir uygulama için geçerlidir.
Aşağıdaki tabloda proje başına sorgu sınırları ayrıntılı olarak açıklanmıştır. 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 dakika başına yazma sayısı |
|
100 |
Dakika başına okuma sayısı |
|
600 |
Kullanıcı başına dakika başına okuma sayısı |
|
100 |
Zamana dayalı kota hatalarını çözme
Zamana dayalı tüm hatalar (X dakika başına en fazla N istek) için kodunuzun istisnayı yakalamasını ve cihazlarınızın aşırı yük oluşturmamasını sağlamak amacıyla kesilmiş üssel geri çekme kullanmasını öneririz.
Üslü geri alma, ağ uygulamaları için standart bir hata işleme stratejisidir. Eksponansiyel geri yükleme algoritması, maksimum geri yükleme süresine kadar istekler arasında katlanarak artan bekleme süreleri kullanarak istekleri yeniden dener. İstekler hâlâ başarısız oluyorsa isteğin başarılı olana kadar istekler arasındaki gecikmenin zaman içinde artması önemlidir.
Örnek algoritma
Eksponansiyel 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 istek gönderin.
- İstek başarısız olursa 1 +
random_number_millisecondssaniye bekleyip isteği tekrar deneyin. - İstek başarısız olursa 2 +
random_number_millisecondssaniye bekleyip isteği tekrar deneyin. - İstek başarısız olursa 4 +
random_number_millisecondssaniye bekleyip isteği tekrar deneyin. - Bu işlem
maximum_backoffkez tekrarlanır. - Beklemeye ve maksimum deneme sayısına kadar yeniden denemeye devam edin ancak yeniden denemeler arasındaki bekleme süresini artırmayın.
Bu örnekte:
- Bekleme süresi
min(((2^n)+random_number_milliseconds), maximum_backoff)'tür.n, her iterasyon (istek) için 1 artar. random_number_milliseconds,1.000'den küçük veya 1.000'e eşit rastgele bir milisaniye sayısıdır. Bu, birçok istemcinin bir durum nedeniyle senkronize edildiği ve isteklerin senkronize dalgalar halinde gönderilerek hepsinin aynı anda yeniden denediği durumların önlenmesine yardımcı olur.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 sonra yapılan yeniden denemelerde bekleme süresinin artırılması gerekmez. Örneğin, bir istemci 64 saniyelik bir maximum_backoff süresi kullanıyorsa bu değere ulaştıktan sonra 64 saniyede bir yeniden deneyebilir. Bir noktada, istemcilerin süresiz olarak yeniden denemeleri engellenmelidir.
Yeniden deneme sayısı ve bu denemeler arasındaki bekleme süresi, kullanım alanınıza ve ağ koşullarına bağlıdır.
Proje başına kota artışı isteme
Projenizin kaynak kullanımına bağlı olarak kota artışı isteyebilirsiniz. Bir hizmet hesabı tarafından yapılan API çağrılarının tek bir hesap kullandığı kabul edilir. Kota artışı başvurusunda bulunmak onay alacağınıza dair bir garanti teşkil 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 daha fazla kullandıkça kotalarınızın artırılması gerekebilir. Kullanımın önemli oranda artacağını düşünüyorsanız Google Cloud Console'daki Kotalar sayfasından, önlem amaçlı olarak kota ayarlama isteğinde bulunabilirsiniz.
Daha fazla bilgi için aşağıdaki kaynaklara göz atın: