Kullanım sınırları

Google Docs API paylaşılan bir hizmet olduğundan, tüm kullanıcılar tarafından adil bir şekilde kullanıldığından emin olmak ve Google Workspace sisteminin genel durumunu korumak için kota 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. Böyle bir durumda üstel geri çekilme algoritması kullanıp daha sonra tekrar denemeniz gerekir.

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

Kotalar
Okuma istekleri
Proje başına dakikada 3.000
Proje başına kullanıcı başına dakikada 300
Yazma istekleri
Proje başına dakikada 600
Proje başına kullanıcı başına dakikada 60

Zamana dayalı kota hatalarını giderme

Tüm zaman tabanlı hatalarda (X dakika başına 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ş üstel geri çekilme kullanmasını öneririz.

Üstel geri çekilme, ağ uygulamaları için standart bir hata işleme stratejisidir. Üstel geri çekilme algoritması, istekler arasındaki bekleme sürelerini önemli ölçüde artırarak maksimum geri yükleme süresine kadar istekleri yeniden dener. İstekler hâlâ başarısız oluyorsa, istek başarılı olana kadar istekler arasındaki gecikmelerin zaman içinde artması önemlidir.

Örnek algoritma

Üslü bir 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:

  1. Google Docs API'ye istekte bulunun.
  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 durumda maximum_backoff saate kadar kullanabilirsiniz.
  6. Beklemeye devam edip maksimum sayıda yeniden denemeye kadar tekrar deneyin. Ancak yeniden denemeler arasındaki bekleme süresini artırmayın.

Bu örnekte:

  • Bekleme süresi min(((2^n)+random_number_milliseconds), maximum_backoff) ve n her iterasyon (istek) için 1'er artar.
  • random_number_milliseconds,1.000 veya daha az rastgele bir milisaniye sayısıdır. Bu, birçok istemcinin bir duruma göre senkronize edildiği ve tümünü tek seferde yeniden denediği, senkronize dalgalarda istek gönderen durumlardan kaçınmanıza yardımcı olur. 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.

Müşteri, maximum_backoff kez ulaştığında tekrar denemeye devam edebilir. Bu noktadan sonra yeniden denemelerin geri alma süresini artırmaya devam etmesi gerekmez. Örneğin, bir müşteri 64 saniyelik maximum_backoff zaman kullanıyorsa bu değere ulaştıktan sonra 64 saniyede bir yeniden deneyebilir. Bir noktada, müşterilerin süresiz olarak yeniden denemelerinin engellenmesi gerekir.

Yeniden denemeler ve 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 Docs API'nin her türlü kullanımı ücretsizdir. Kota isteği sınırlarının aşılması durumunda ek ücret alınmaz ve hesabınız faturalandırılmaz.

Kota artışı isteme

Projenizin kaynak kullanımına bağlı olarak kota artışı talep edebilirsiniz. Bir hizmet hesabının API çağrıları, tek bir hesap kullanıyor olarak kabul edilir. Artan bir kotaya başvurmak onay almak anlamına gelmez. Büyük kota artışlarının onaylanması daha uzun sürebilir.

Her projenin kotası aynı değildir. Google Cloud'u giderek daha fazla kullandıkça kotalarınızın artması gerekebilir. Kullanımın önemli ölçüde artacağını düşünüyorsanız Google Cloud Console'daki Kotalar sayfasından proaktif olarak kotaların ayarlanmasını isteyebilirsiniz.

Daha fazla bilgi edinmek için aşağıdaki kaynakları inceleyin: