Sınırlar ve kotalar, Google altyapısını Alert Center API'sini uygunsuz bir şekilde kullanan otomatik bir süreçten 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 düzeyde trafiğe ulaşıldığında belirli bir kaynaktan gelen trafiğin engellenmesi, Google Workspace sisteminin genel sağlığı için gereklidir. Bir geliştiricinin eylemlerinin daha büyük topluluğu olumsuz etkilemesini önlemeye yardımcı olur.
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 yararlı olmadığını unutmayın. İstek sayısı çok yükselirse kota hataları oluşur.
Özellikle 503 durum kodu hataları olmak üzere, zamana dayalı tüm hatalar (iş parçacığı başına N saniyede en fazla N öğe) 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 ileti dizileri için de tekrarlayın. İkinci istek başarılı olmazsa uygulamanız, 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 aramayı 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, Google Cloud 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 bir HTTP |
| 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ğlanmazsa 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 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:
- Kota ayarlamaları hakkında
- Kota kullanımınızı ve sınırlarınızı görüntüleme
- Daha yüksek bir kota sınırı isteğinde bulunma