Kullanım sınırları

Google Drive 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 performansını korumak için kotalar ve sınırlamalar uygularız.

Bildirim kanalı açarken belirtilen adrese gönderilen bildirimler, kota sınırlarınıza dahil edilmez. Ancak changes.watch, channels.stop ve files.watch yöntemlerine yapılan çağrılar kotanıza dahil edilir.

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 429: Too many requests yanıtı oluşturabilir. Bu durumda, eksponansiyel geri yükleme algoritması kullanmalı ve daha sonra tekrar denemelisiniz. Aşağıdaki dakikalık kotalar dahilinde kalmanız koşuluyla, günlük olarak gönderebileceğiniz istek sayısı sınırsızdır.

Aşağıdaki tabloda sorgu sınırlamaları ayrıntılı olarak açıklanmıştır:

Kotalar
Sorgular
60 saniye başına 12.000
Kullanıcı başına 60 saniye başına 12.000

Zamana dayalı kota hatalarını çözme

Zamana dayalı tüm hatalar için (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 kısaltılmış eksponansiyel geri yükleme kullanmasını öneririz.

Üslü geri alma, ağ uygulamaları için standart bir hata işleme stratejisidir. Eksponansiyel geri yükleme algoritması, maksimum geri yükleme süresine kadar istekler arasında katlanarak artan bekleme süreleri kullanarak istekleri yeniden dener. İstekler hâlâ başarısız oluyorsa isteğin başarılı olana kadar istekler arasındaki gecikmenin zaman içinde artması önemlidir.

Örnek algoritma

Eksponansiyel 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 Drive API'ye istek gönderin.
  2. İstek başarısız olursa 1 + random_number_milliseconds saniye bekleyip isteği tekrar deneyin.
  3. İstek başarısız olursa 2 + random_number_milliseconds saniye bekleyip isteği tekrar deneyin.
  4. İstek başarısız olursa 4 + random_number_milliseconds saniye bekleyip isteği tekrar deneyin.
  5. Bu işlem maximum_backoff kez tekrarlanır.
  6. Beklemeye ve maksimum deneme sayısına kadar yeniden denemeye devam edin ancak denemeler arasındaki bekleme süresini artırmayın.

Bu örnekte:

  • Bekleme süresi min(((2^n)+random_number_milliseconds), maximum_backoff) olup n her yineleme (istek) için 1 artırılır.
  • random_number_milliseconds,1.000'den küçük veya 1.000'e eşit rastgele bir milisaniye sayısıdır. Bu, birçok istemcinin bir durum nedeniyle senkronize edildiği ve isteklerin senkronize dalgalar halinde gönderilerek hepsinin aynı anda yeniden denediği durumların önlenmesine 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ıyorsa bu değere ulaştıktan sonra 64 saniyede bir yeniden deneyebilir. Bir noktada, istemcilerin süresiz olarak yeniden denemeleri 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 Drive API'nin kullanımı için ek ücret alınmaz. Kota isteği sınırlarının aşılması ek ücrete neden olmaz ve hesabınıza fatura gönderilmez.

Kota artışı isteme

Projenizin kaynak kullanımına bağlı olarak kota artışı talep edebilirsiniz. Bir hizmet hesabı tarafından yapılan API çağrılarının tek bir hesap kullandığı kabul edilir. Kota artışı başvurusunda bulunmak onay alacağınıza dair bir garanti teşkil 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 daha fazla kullandıkça kotalarınızın artırılması gerekebilir. Kullanımın önemli oranda artacağını düşünüyorsanız Google Cloud Console'daki Kotalar sayfasından, önlem amaçlı olarak kota ayarlama isteğinde bulunabilirsiniz.

Daha fazla bilgi edinmek için aşağıdaki kaynaklara göz atın: