Kullanım sınırları

Google Drive API paylaşılan bir hizmet olduğundan, tüm kullanıcıların bu hizmeti adil bir şekilde kullanmasını sağlamak ve Google Workspace sisteminin genel performansını korumak için kotalar ve sınırlamalar uygularız.

Sınırlar, Google Drive kaynak kullanımını temsil eden soyut bir ölçü birimi olan kota birimleri cinsinden tanımlanır.

Drive API kotaları

Üç tür kota uygulanır:

  • Proje başına dakikada: Bu, Google Cloud projenizin bir dakikada kullanabileceği kota birimi sayısıdır.

  • Proje başına kullanıcı başına dakika: Bu, belirli bir kullanıcının Cloud projenizde kullanabileceği kota birimlerinin sayısıdır. Bu sınır, kullanımın kullanıcılarınız arasında adil bir şekilde dağıtılmasını sağlamanıza yardımcı olmayı amaçlar.

  • Proje başına günlük: Bu, ücret uygulanmadan önce Google Cloud projenizin 24 saatlik bir süre içinde çıkış yapabileceği maksimum bayt sayısını tanımlar.

Aşağıdaki tabloda bu sınırlar ayrıntılı olarak açıklanmaktadır:

Kullanım sınırı türü Sınır
Proje başına dakika 1.000.000 kota birimi
Proje başına kullanıcı başına dakikada 325.000 kota birimi
Proje başına günlük 1 TB

Bir kotayı aşarsanız 403: User rate limit exceeded HTTP durum kodu yanıtı alırsınız. Drive arka ucunda ek sıklık sınırı kontrolleri de 429: Rate limit exceeded yanıtı oluşturabilir. Bu durumda eksponansiyel geri yükleme algoritması kullanmanız ve daha sonra tekrar denemeniz gerekir.

Günlük faturalandırma eşiği

Bu proje başına günlük sınır, ücretlendirme başlamadan önce Google Cloud projenizin 24 saatlik bir süre içinde kullanabileceği maksimum kota birimi sayısını tanımlar.

Bu eşiğin altındaki kullanım için ek ücret alınmaz ve Google Cloud hesabınız faturalandırılmaz. Faturalandırmayla ilgili tüm ayrıntılar, 2026'da değişiklikler yürürlüğe girmeden en az 90 gün önce paylaşılacaktır.

Bu günlük eşik sınırını artırma isteğinde bulunamazsınız.

Sınırla ilgili ayrıntılar aşağıdaki tabloda verilmiştir:

Eşik sınırlama türü Sınır
Proje başına günlük 400.000.000 kota birimi

Daha fazla bilgi için Google Workspace standardized model for agent tools and APIs başlıklı makaleyi inceleyin.

Yöntem başına kota kullanımı

İstek başına tüketilen kota birimi sayısı, çağrılan yönteme göre değişir. Aşağıdaki tabloda, yöntem başına kota birimi kullanımı özetlenmiştir:

İşlem Kota birimleri
files.get gibi öğeleri okuma 5
Liste öğeleri (ör. files.list) 100
files.download gibi öğeleri indirme 200
files.update gibi öğeleri düzenleme 50
files.generateIds gibi diğer işlemler 5

Ek kısıtlamalar

Drive API ile çalışırken aşağıdaki kısıtlamalar uygulanır:

  • Google Workspace kullanıcıları, Drive'ım ile tüm ortak drive'lar arasında günde en fazla 750 GB veri yükleyebilir. Bu sınır, kopyalar için de geçerlidir.

  • 750 GB sınırına ulaşan veya 750 GB'tan büyük dosya yükleyen kullanıcılar 24 saat geçene kadar başka dosya yükleyemez veya kopyalayamaz.

  • Kullanıcıların yükleyebileceği maksimum dosya boyutu 5 TB'tır. Yalnızca sınırı aşan ilk dosyanın yükleme işlemi tamamlanır. Kullanıcıların kopyalayabileceği maksimum dosya boyutu 750 GB'tır.

  • Bildirim kanalı açılırken 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.

  • Dakika başına kota sınırları içinde kaldığınız sürece, günlük istek sayınız sınırsızdır.

  • Google Workspace hesabınızın türüne bağlı olarak ek Drive depolama alanı sınırları vardır.

Zamana dayalı kota hatalarını düzeltme

Zamana dayalı tüm hatalar (X dakika başına en fazla N istek) için kodunuzun istisnayı yakalamasını ve cihazlarınızın aşırı yük oluşturmadığından emin olmak için kısaltılmış eksponansiyel geri yükleme kullanmasını öneririz.

Eksponansiyel geri yükleme, ağ uygulamaları için standart bir hata işleme stratejisidir. Eksponansiyel geri yükleme algoritması, istekler arasındaki bekleme sürelerini üstel olarak artırarak istekleri yeniden dener. Bu işlem, maksimum geri yükleme süresine kadar devam eder. İ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

Eksponansiyel geri yükleme algoritması, istekleri eksponansiyel olarak 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 istekte bulunma
  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 saniye bekleyip isteği yeniden deneyin.
  4. İstek başarısız olursa 4 + random_number_milliseconds saniye bekleyin ve isteği yeniden deneyin.
  5. Bu işlem maximum_backoff kez tekrarlanabilir.
  6. Maksimum deneme sayısına ulaşana kadar beklemeye ve yeniden denemeye devam edin ancak yeniden denemeler arasındaki bekleme süresini artırmayın.

Bu örnekte:

  • Bekleme süresi min(((2^n)+random_number_milliseconds), maximum_backoff)'dır. Her yineleme (istek) için n değeri 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 sayede, birçok istemcinin belirli bir durum nedeniyle senkronize olup aynı anda yeniden denediği ve senkronize dalgalar halinde istek gönderdiği durumlar önlenir. 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 sonraki yeniden denemelerde geri yükleme aralığı süresinin artırılmasına gerek yoktur. Örneğin, bir istemci 64 saniyelik bir maximum_backoff kullanıyorsa bu değere ulaştıktan sonra her 64 saniyede bir yeniden deneyebilir. Bir noktada, istemcilerin süresiz olarak yeniden denemesi engellenmelidir.

Yeniden denemeler arasındaki bekleme süresi ve yeniden deneme sayısı, kullanım alanınıza ve ağ koşullarına bağlıdır.

Fiyatlandırma

Google Drive API'nin tüm standart kullanımı ek ücret ödemeden yapılabilir. Kota istek sınırlarının aşılması nedeniyle 2026'nın ilerleyen dönemlerinde Google Cloud Faturalandırma Hesabınızdan ücret alınması planlanmaktadır. Daha fazla bilgi için Google Workspace'in aracı araçları ve API'leri için standartlaştırılmış modeli başlıklı makaleyi inceleyin.

Kota artışı isteme

Projenizin kaynak kullanımına bağlı olarak kota ayarlaması isteğinde bulunmak isteyebilirsiniz. Bir hizmet hesabı tarafından yapılan API çağrıları, tek bir hesap kullanılıyormuş gibi değerlendirilir. Ayarlanmış kota başvurusunda bulunmak onay alacağınıza dair bir garanti teşkil etmez. Kota değerini önemli ölçüde artıracak kota ayarlama isteklerinin onaylanması daha uzun sürebilir.

Her projenin kotası aynı değildir. Google Cloud'u zaman içinde daha fazla kullandıkça kota değerlerinizin artırılması gerekebilir. Kullanımın önemli oranda artacağını düşünüyorsanız Google Cloud Console'daki Kotalar ve Sistem Sınırları sayfasından önlem amaçlı olarak kota ayarlaması isteyebilirsiniz.

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