Kullanım sınırları ve kotalar

Sınırlar ve kotalar, Google altyapısını Uyarı Merkezi API'sini uygunsuz bir şekilde kullanan otomatik süreçlerden korur. Bir API'den gelen aşırı istekler, zararsız bir yazım hatasından veya gereksiz API çağrıları yapan verimsiz tasarlanmış bir sistemden kaynaklanabilir. Nedeni ne olursa olsun, belirli bir kaynaktan gelen trafiğin belirli bir düzeye ulaştıktan sonra engellenmesi, Google Workspace sisteminin genel sağlığı için gereklidir. Bu sayede bir geliştiricinin eylemleri daha büyük topluluğu olumsuz etkileyemez.

API isteğinizin başarısız olması durumunda bir HTTP durum kodu yanıtı alırsınız. 403 durum kodu, yanlış girişle ilgili hata bilgilerini, 503 HTTP durum kodu ise hangi API kotalarının aşıldığını belirten hata bilgilerini içerir. Bu yanıtlar, özel uygulamanızın bu hataları algılamasına ve uygun işlemi yapmasına olanak tanır.

İsteklerinizin belirli bir süre içinde tamamlanması gerekiyorsa isteklerinizi paralel olarak gönderin veya Java ya da C# uygulamanızda birden fazla iş parçacığı kullanın. Paralel isteklere örnek olarak, tek bir kullanıcıdan çok sayıda e-posta eklemek veya kaldırmak yerine farklı kullanıcılardan küçük e-posta grupları istemek verilebilir. İş parçacıkları söz konusu olduğunda, kullanıcı e-postası başına bir iş parçacığı olacak şekilde 10 iş parçacığıyla başlamayı deneyin. İş parçacığı önerisinin dezavantajları olduğunu ve tüm API durumlarında işe yaramadığını unutmayın. İstek sayısı çok yükselirse kota hataları oluşur.

Zamana dayalı tüm hatalar (iş parçası başına N saniye için en fazla N öğe), özellikle 503 durum kodu hataları için kodunuzun istisnayı yakalamasını ve üstel geri çekilme algoritması kullanarak başarısız olan çağrıyı yeniden denemeden önce kısa bir süre beklemesini öneririz. Bir iş parçacığı için Alert Center API örneği, 5 saniye bekleyip başarısız olan çağrıyı yeniden denemektir. İstek başarılı olursa bu kalıbı diğer iş parçacıkları için tekrarlayın. İkinci istek başarılı olmazsa uygulamanız, bir arama başarılı olana kadar isteğin sıklığını azaltmalıdır. Örneğin, ilk 5 saniyelik gecikmeyi 10 saniyeye çıkarın ve başarısız olan çağrınızı tekrar deneyin. Ayrıca, yeniden deneme sınırı belirleyin. Örneğin, uygulamanız kullanıcıya hata döndürmeden önce isteği farklı gecikme süreleriyle 5-7 kez yeniden deneyin.

API Sınır Kategorileri Sınırlar
Uyarı Merkezi'nin QPS ve QPD oranları API, API Konsolu projeniz için istek sayısını sınırlar. API projesinin saniyedeki maksimum istek sayısı (proje QPS) 1.000'dir. Ayrıca, kullanıcı başına saniyedeki maksimum istek sayısı (kullanıcı QPS) 150'dir.

Bu sınırlar aşılırsa sunucu, HTTP 503 durum kodu döndürür. İsteklerinizi yeniden denerken eksponansiyel geri yükleme algoritmasını kullanın.

Diğer Sınır Türleri Sınırlamalar ve Yönergeler
Veri biçimi, varsayılan Varsayılan veri biçimi JSON'dur.
Yetkisiz istekler Google, bu API'ye yetkisiz isteklerin gönderilmesine izin vermez. Yetkilendirme jetonu sağlanmadığında istek yetkisiz olarak kabul edilir. Daha fazla bilgi için İstekleri yetkilendirme başlıklı makaleyi inceleyin.

Proje başına kota artışı isteğinde bulunma

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ı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 artması 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 bakın: