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 |
|
||
Yazma istekleri |
|
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:
- Drive Etiketler API'ye istekte bulunun.
- İstek başarısız olursa 1 +
random_number_milliseconds
bekleyin ve isteği yeniden deneyin. - İstek başarısız olursa 2 +
random_number_milliseconds
bekleyin ve isteği yeniden deneyin. - İstek başarısız olursa 4 +
random_number_milliseconds
bekleyin ve isteği yeniden deneyin. - Bu şekilde en fazla
maximum_backoff
defa 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 ven
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:
- Kota artışı istekleri hakkında
- Mevcut kota kullanımınızı ve sınırlarınızı görüntüleme
- Kota sınırının artırılmasını isteme