Kullanım sınırları

Google Vault 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 sağlığını korumak için kotalar ve sınırlamalar uygularız.

Ürün sınırları

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

API istek kotası

Her kuruluşun, Vault API ve vault.google.com üzerinden yapılan istekler de dahil olmak üzere tüm projeler ve kullanıcılar için dakikada 600 olay okumasına izin verilir.

Aşağıdaki tablolarda, dakika başına proje başına istek sınırları listelenmektedir:

Proje başına 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
Dava izinleri 30
Matter 60
Kayıtlı sorgu 45
Proje başına bir dakikada arama (sayı) isteği sayısı
Arama sayıları 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önteme göre 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 yazıldı
matters.count 1 adet
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 okundu
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 dışa aktarma okuma
matters.holds.addHeldAccounts
matters.holds.create
matters.holds.delete
matters.holds.removeHeldAccounts
matters.holds.update 		1 konu okuma
1 konu yazma
1 saklama okuma
1 saklama yazma
matters.holds.list 1 konu okundu
3 bekletme okuması
matters.holds.accounts.create
matters.holds.accounts.delete
matters.holds.accounts.list 		1 konu okuma
1 konu yazma
1 saklama okuma
1 saklama 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 okunmuş konu
1 okunmuş kayıtlı sorgu
matters.savedQueries.list 1 konu okundu
3 kayıtlı sorgu okundu
operations.get 1 uzun süreli işlem okuma

Zamana dayalı kota hatalarını düzeltme

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.

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ış üstel geri çekilme kullanmasını öneririz.

Üstel geri alma, 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. Maksimum geri yükleme süresine kadar bu işlem 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 Vault API'ye istek gönderin.
  2. İstek başarısız olursa 1 + random_number_milliseconds saniye 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 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 kez denedikten sonra yeniden denemeye devam edebilir. Bu noktadan sonraki yeniden denemelerde geri çekilme süresinin artırılması gerekmez. Örneğin, bir istemci 64 saniyelik bir maximum_backoff kullanıyorsa bu değere ulaştıktan sonra istemci 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.

Kota artışı isteme

Projenizin kaynak kullanımına bağlı olarak kota ayarlaması isteğinde bulunabilirsiniz. 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 sayfasından önlem amaçlı olarak kota ayarlamaları isteyebilirsiniz.

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

Fiyatlandırma

Google Vault API'nin tüm kullanımı, Google Workspace müşterileri için ek ücret alınmadan kullanılabilir.