Google Drive API ortak bir hizmet olduğundan, tüm kullanıcılar tarafından adil kullanıldığından emin olmak ve Google Workspace sisteminin genel performansını korumak için kotalar ve sınırlamalar uygularız.
Bir bildirim kanalı açılırken belirtilen adrese gönderilen bildirimler kota sınırlarınızı etkilemez. Bununla birlikte, changes.watch
, channels.stop
ve files.watch
yöntemlerine yapılan çağrılar kotanızdan düşülür.
Bir kotayı aşarsanız 403: User rate limit
exceeded
HTTP durum kodu yanıtı alırsınız. Drive arka ucundaki ek hız sınırı kontrolleri de bir 429: Too many
requests
yanıtı oluşturabilir. Böyle bir durumda üstel geri çekilme algoritması kullanıp daha sonra tekrar denemeniz gerekir. Aşağıdaki dakika başına kotaları aşmadığınız sürece günlük gönderebileceğiniz istek sayısı sınırlı değildir.
Aşağıdaki tabloda sorgu sınırları ayrıntılı olarak açıklanmıştır:
Kotalar | |||||
---|---|---|---|---|---|
Sorgular |
|
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:
- Google Drive 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
Google Drive API'nin kullanımı için ek ücret ödenmesi gerekmez. 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