Kullanım sınırları

Drive Etiketler API ortak bir hizmet olduğundan, tüm kullanıcılar tarafından adil kullanıldığından emin olmak ve Google Workspace ekosisteminin genel durumunu korumak için kotalar ve sınırlamalar uyguluyoruz.

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ı kullanmanız ve daha sonra tekrar denemeniz gerekir. Aşağıdaki dakika başına kotaları aşmadığınız sürece günlük olarak gönderebileceğiniz istek sayısı sınırlı değildir.

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

Kotalar
Okuma istekleri
Proje başına kullanıcı başına 600 (saniyedeki sorgu sayısı)
Yazma istekleri
Proje başına kullanıcı başına 300 (saniyedeki sorgu sayısı)

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:

  1. Drive Etiketler 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 şekilde en fazla maximum_backoff defa girebilirsiniz.
  6. 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 ve n her 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_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 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.

Fiyatlandırma

Drive Etiketler API'nin kullanımı ek ücret olmadan sunulur. Kota istek sınırlarını aşabilmek için 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ı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: