Kullanım sınırları

Google Vault API ortak bir hizmet olduğundan tüm kullanıcılar tarafından adil kullanıldığından emin olmak ve Google Workspace sisteminin genel durumunu korumak için kotalar ve sınırlamalar uygularız.

Ürün sınırları

Kuruluşunuz genelinde devam eden en fazla 20 dışa aktarma işleminiz olabilir.

API isteği kotaları

Her kuruluşa, tüm projeler ve kullanıcılar genelinde, Vault API ve vault.google.com üzerinden gönderilen istekler de dahil olmak üzere dakikada 600 konu okuma izni verilir.

Aşağıdaki tablolarda, proje başına dakikalık istek sınırları listelenmiştir:

Proje başına bir dakikada okuma isteği sayısı
Dışa aktarma, konu ve kayıtlı sorgu 120
Beklet 228
Uzun süreli işlem 300
Proje başına dakikada yazma isteği sayısı
Dışa aktar 20
Beklet 60
Konu izinleri 30
Matter 60
Kayıtlı sorgu 45
Proje başına bir dakikada arama (sayı) isteği
Sayı ara 20

Yönteme göre kota kullanımı

Bir istek tarafından kullanılan kota, çağrılan yönteme bağlıdır. Aşağıdaki tabloda yöntem başına kota kullanımı listelenmiştir:

Yöntem Kota maliyetleri
matters.close
matters.create
matters.delete
matters.reopen
matters.update
matters.undelete 		1 konu okundu
1 konu yazma
matters.count 1 sayı
matters.get 1 konu okundu
matters.list 10 konu okuma
matters.addPermissions
matters.removePermissions 		1 konu okuma
1 konu yazma
1 konu izinleri yazma
matters.exports.create 1 dışa aktarma okuması
10 dışa aktarma yazma işlemi
matters.exports.delete 1 dışa aktarma yazma
matters.exports.get 1 dışa aktarma okundu
matters.exports.list 5 okumayı dışa aktar
matters.holds.addHeldAccounts
matters.holds.create
matters.holds.delete
matters.holds.removeHeldAccounts
matters.holds.update 		1 konu okundu
1 konu yazma
1 muhafaza okuma
1 bekletme yazma
matters.holds.list 1 konu okundu
3 muhafaza okuma
matters.holds.accounts.create
matters.holds.accounts.delete
matters.holds.accounts.list 		1 konu okundu
1 konu yazma
1 muhafaza okuma
1 bekletme yazma
matters.savedQueries.create
matters.savedQueries.delete 		1 konu okuma
1 konu yazma
1 kayıtlı sorgu okuma
1 kayıtlı sorgu yazma
matters.savedQueries.get 1 konu okundu
1 kayıtlı sorgu okundu
matters.savedQueries.list 1 konu okundu
3 kayıtlı sorgu okuma
operations.get Uzun süreli 1 işlem okuma

Zamana dayalı kota hatalarını çözme

Dakika başına veya kuruluş başına kotayı aşarsanız genellikle 429: Too many requests HTTP durum kodu yanıtı alırsınız.

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:

  1. Google Vault API'ye istekte bulunun.
  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 en fazla maximum_backoff defa girebilirsiniz.
  6. 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 ve n 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.

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:

Fiyatlandırma

Google Apps Kasası müşterileri hiçbir ek ücret ödemeden Google Vault API'nin kullanımından yararlanabilir.