Kullanım sınırları

Google Meet REST API ortak bir hizmet olduğundan, tüm kullanıcılar tarafından adil bir şekilde kullanıldığından emin olmak ve Google Workspace sisteminin genel performansını korumak için kotalar ve sınırlamalar uygularız.

Bir kotayı aşarsanız genellikle 429: Too many requests HTTP durum kodu yanıtı alırsınız. Bu durumda üstel geri çekilme algoritması kullanıp daha sonra tekrar denemeniz gerekir. Dakika başına kotaları aşmadığınız sürece günlük gönderebileceğiniz istek sayısında bir sınır yoktur.

Aşağıdaki tabloda sorgu sınırları ayrıntılı olarak verilmiştir:

Kotalar
Okuma istekleri
Proje başına bir dakika 6.000
Proje başına bir dakikada kullanıcı başına dakikada 600
Yazma istekleri
Proje başına bir dakika 1000
Proje başına bir dakikada kullanıcı başına dakikada 100
Azaltılmış yazma isteği sayısı

(spaces.create istekleri için kullanılır.)

Proje başına bir dakika 100
Proje başına bir dakikada kullanıcı başına dakikada 10

Zamana dayalı kota hatalarını çözme

Zamana dayalı tüm hatalarda (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 işlemi kullanmanızı öneririz.

Üstel geri yükleme, ağ uygulamaları için standart bir hata işleme stratejisidir. Eksponansiyel geri yükleme algoritması, istekler arasında maksimum geri yükleme süresine kadar katlanarak artan bekleme sürelerini kullanarak istekleri yeniden dener. İstekler yine de başarısız olursa, istek başarılı olana kadar istekler arasındaki gecikmelerin zaman içinde artması önemlidir.

Örnek algoritma

Eksponansiyel geri yükleme algoritması, istekleri katlanarak yeniden dener. Böylece yeniden denemeler arasındaki bekleme süresi maksimum geri yükleme süresine kadar uzatılır. Örneğin:

  1. Google Meet API'ye istek gönderin.
  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 bekleyip isteği yeniden deneyin.
  5. Bu şekilde maximum_backoff defaya kadar devam edebilirsiniz.
  6. Beklemeye devam edip maksimum yeniden deneme sayısına kadar yeniden deneyebilirsiniz. Ancak yeniden denemeler arasındaki bekleme süresini uzatmayın.

Bu örnekte:

  • Bekleme süresi min(((2^n)+random_number_milliseconds), maximum_backoff) şeklindedir ve n her iterasyon (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 işlem, çok sayıda istemcinin bir durum nedeniyle senkronize edildiği ve tüm istemcilerin aynı anda yeniden denediği durumların önlenmesine yardımcı olur. Böylece, isteklerin senkronize dalgalar halinde gönderilmesi sağlanır. 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 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 denemeler 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.

Fiyatlandırma

Google Meet API tamamen ücretsiz olarak kullanılabilir. Kota istek sınırları aşıldığında ek ücret alınmaz ve hesabınız faturalandırılmaz.

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 da 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 kaynakları inceleyin: