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ılması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 dakika başına: Google Cloud projenizin bir dakikada kullanabileceği kota birimi sayısıdır.

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

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

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

Kullanım sınırı türü Sınır
Proje başına dakikalık 1.000.000 kota birimi
Proje başına kullanıcı başına dakikalık 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 ucundaki ek sıklık sınırlaması 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

Proje başına günlük olarak belirlenen bu sınır, Google Cloud projenizin ücretlendirme uygulanmadan önce 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 geçerlilik kazanmadan en az 90 gün önce paylaşılacak.

Bu günlük eşik sınırının artırılmasını talep edemezsiniz.

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

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

Daha fazla bilgi için Temsilci araçları ve API'ler için Google Workspace standartlaştırılmış modeli başlıklı makaleyi inceleyin.

Yöntem başına kota birim maliyetleri

İstek başına tüketilen kota birimi sayısı, aşağıdaki tablolarda açıklandığı gibi çağrılan yönteme göre değişir:

Okuma yöntemleri (5 kota birimi)

Yöntem
drive.about.get
drive.accessproposals.get
drive.apps.get
drive.approvals.get
drive.changes.get
drive.children.get
drive.comments.get
drive.drives.get
drive.files.get (without alt=media)
drive.parents.get
drive.permissions.get
drive.properties.get
drive.replies.get
drive.revisions.get (without alt=media)
drive.teamdrives.get

List yöntemleri (100 kota birimi)

Yöntem
drive.accessproposals.list
drive.apps.list
drive.changes.list, drive.changes.watch
drive.children.list
drive.comments.list
drive.drives.list
drive.files.list, drive.files.watch
drive.parents.list
drive.permissions.list
drive.properties.list
drive.replies.list
drive.revisions.list
drive.teamdrives.list

Düzenleme yöntemleri (50 kota birimi)

Yöntem
drive.approvals.decline
drive.children.delete, drive.children.insert
drive.comments.create, drive.comments.delete, drive.comments.insert, drive.comments.patch, drive.comments.update
drive.drives.create, drive.drives.delete, drive.drives.hide, drive.drives.insert, drive.drives.unhide, drive.drives.update
drive.files.copy, drive.files.create, drive.files.delete, drive.files.emptyTrash, drive.files.insert, drive.files.modifyLabels, drive.files.patch, drive.files.touch, drive.files.trash, drive.files.untrash, drive.files.update
drive.parents.delete, drive.parents.insert
drive.permissions.create, drive.permissions.delete, drive.permissions.insert, drive.permissions.patch, drive.permissions.update
drive.properties.delete, drive.properties.insert, drive.properties.patch, drive.properties.update
drive.replies.create, drive.replies.delete, drive.replies.insert, drive.replies.patch, drive.replies.update
drive.revisions.delete, drive.revisions.patch ve drive.revisions.update
drive.teamdrives.create, drive.teamdrives.delete, drive.teamdrives.insert, drive.teamdrives.update

İndirme yöntemleri (200 kota birimi)

Yöntem
drive.files.download, drive.files.export ve drive.files.get (with alt=media)
drive.revisions.get (with alt=media)

Diğer yöntemler (5 kota birimi)

Yöntem
drive.changes.getStartPageToken
drive.channels.stop
drive.files.generateCseToken, drive.files.generateIds ve drive.files.listLabels
drive.operations.get
drive.permissions.getIdForEmail

Ek kısıtlamalar

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

  • Google Workspace kullanıcıları, Drive'ım ve tüm ortak Drive'lar arasında günde yalnızca 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 bir 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ızdan düşülmez. Ancak changes.watch, channels.stop ve files.watch yöntemlerine yapılan çağrılar kotanızdan düşülür.

  • Dakika başına kotaları aşmadığınız sürece, günde gönderebileceğiniz istek sayısıyla ilgili bir sınır yoktur.

  • 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ı çözme

Zamana dayalı tüm hatalar için (X dakikada en fazla N istek) kodunuzun istisnayı yakalamasını ve cihazlarınızın aşırı yük oluşturmamasını sağlamak için kesilmiş 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ında eksponansiyel olarak artan bekleme süreleri kullanarak istekleri yeniden dener. Bu süre, maksimum geri yükleme süresine kadar artar. İstekler hâlâ başarısız oluyorsa istek başarılı olana kadar istekler arasındaki gecikme süresinin 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 istek gönderme
  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 maximum_backoff kez devam eder.
  6. Maksimum deneme sayısına ulaşana kadar beklemeye ve 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 iterasyon (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 sayede, birçok istemcinin bir durum nedeniyle senkronize edildiği ve hepsinin aynı anda yeniden deneme yaparak 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 bekleme süresinin artırılmasına gerek yoktur. Örneğin, bir istemci 64 saniyelik bir maximum_backoff süresi 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ınıza bağlıdır.

Fiyatlandırma

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

Kota artışı isteme

Projenizin kaynak kullanımına bağlı olarak kota düzenlemesi isteyebilirsiniz. Bir hizmet hesabı tarafından yapılan API çağrılarının tek bir hesap kullandığı kabul edilir. Kota düzenlemesi 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. Zaman içinde Google Cloud'u daha fazla kullandıkça kota değerlerinizin artırılması gerekebilir. Kullanımda kayda değer bir artış bekliyorsanız Google Cloud Console'daki Kotalar ve Sistem Sınırları sayfasından proaktif olarak kota düzenlemesi isteyebilirsiniz.

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

Drive MCP sunucusu kotaları

Drive MCP sunucusu, sorgu maliyeti tahsis metriği kullanır. Aşağıdaki tablolarda, her Drive MCP sunucusu yönteminin sorgu maliyeti bölümlere göre ayrıntılı olarak açıklanmıştır:

Drive MCP kotaları

İki tür kota uygulanır:

  • Proje başına dakika başına: Bu, Google Cloud projenizin bir dakikalık sorgu maliyetidir.

  • Kullanıcı başına her projede bir dakika içinde gönderilen istek sayısı: Bu, herhangi bir kullanıcının bir dakika boyunca kullanabileceği Google Cloud projenizin sorgu maliyetidir.

Aşağıdaki tabloda bu kotalar ayrıntılı olarak açıklanmıştır:

Kullanım sınırı türü Sınır
Proje başına dakikalık 325.000
Proje başına kullanıcı başına dakikalık 1.000.000

Drive MCP araç seti kotaları

Aşağıdaki tabloda, her drivemcp.googleapis.com araç seti için sorgu maliyeti ayrıntılı olarak açıklanmaktadır:

Uç nokta Araç Sorgu maliyeti

/mcp/v1

copy_file

50

create_file

50

download_file_content

200

get_file_metadata

5

get_file_permissions

5

list_recent_files

100

read_file_content

200

search_files

100

Daha fazla bilgi için Drive MCP API Referansı'na bakın.