Sınırlar ve kotalar, Google altyapısını Groups Settings API'yi uygunsuz bir şekilde kullanıyor. Bir API'den gelen aşırı sayıda istek zararsız yazım hataları veya gereksiz API çağrıları yapan, verimsiz şekilde tasarlanmış bir sistemdir. Nedenden bağımsız olarak, belirli bir kaynaktan gelen trafiğin belirli bir düzeye ulaştığında engellenmesi, Google Workspace sisteminin genel sağlığı için gereklidir.
API isteği hataları
Çok düşük bir ihtimal de olsa API isteğinizin başarısız olması durumunda uygulamanız bir HTTP durum kodu alır
tıklayın. 403 HTTP durum kodunda hangi API kotalarını gösteren hata bilgileri var
sınır aşılmıştır. Yanıt, özel uygulamanızın hataları tespit etmesini ve gereken işlemleri yapmasını sağlar
eyleme dökülebilir.
Zamana duyarlı istekler
İsteklerinizin belirli bir süre içinde tamamlanması gerekiyorsa isteklerinizi paralel olarak gönderin veya Java ya da C# uygulamanızda birden çok iş parçacığı kullanın. Örneğin, isteklerinizi aylara veya kullanabilirsiniz. İleti dizileri söz konusu olduğunda, istek başına bir ileti dizisi olacak şekilde 10 ileti dizisiyle başlamayı deneyin. İş parçacığı önerisi bazı avantajlara sahiptir ve tüm API durumları için kullanışlı değildir. Rapordaki aşırı yüksek olduğunda kota hataları oluşur.
Zamana bağlı hatalar
Zamana dayalı tüm hatalar için (iş parçacığı başına X saniye için en fazla N şey), özellikle de
503 durum kodu hatası varsa kodunuzun istisnayı yakalamasını ve
eksponansiyel geri yükleme
algoritmasından sonra, başarısız çağrıyı yeniden denemeden önce kısa bir gecikme süresi bekleyin. Şunun için Groups Settings API örneği:
iş parçacıklarından biri 5 saniye bekleyip başarısız aramayı yeniden denemektir. İstek başarılı olursa bunu tekrarla
desenini oluşturabilirsiniz. İkinci isteğiniz başarılı olmazsa başvurunuz
bir arama başarılı olana kadar istek sıklığını ölçeklendirebilir. Örneğin,
İlk 5 saniyelik gecikmeyi 10 saniyeye çıkarın ve başarısız aramanızı tekrar deneyin. Ayrıca, yeniden denemeye karar verin
limit. Örneğin, bir isteği uygulamanızdan önce farklı gecikme süreleriyle 5-7 kez yeniden deneyin
kullanıcıya bir hata döndürür.
Kotalar
| API kota kategorileri | Kotalar |
|---|---|
| Günlük sorgu sayısı | Günde en fazla 100.000 sorgu oluşturabilirsiniz. Kapasitenin isterseniz Google Cloud Console'daki Kotalar sayfası |
| Grup açıklaması, maksimum boyut | 4.096 karaktere kadar bir grup açıklaması girebilirsiniz. |
| Grup adı, maksimum boyut | Bir grubun adı en fazla 60 karakterden oluşabilir. |
defaultMessageDenyNotificationText |
Bildirim metni en fazla 10.000 karakter olabilir.
defaultMessageDenyNotificationText mülkü için
API referansı.
|
maxMessageBytes |
Varsayılan maksimum ileti boyutu 1 MB'tır. maxMessageBytes hakkında daha fazla bilgi edinmek için
özelliği için API referansına bakın.
|
Sınırlar
| Sınır türleri | Sınırlamalar ve yönergeler |
|---|---|
| Veri biçimi, varsayılan |
Varsayılan veri biçimi JSON'dir. API, Atom biçimini de destekler. JSON ve Atom veri biçimleri tam okuma-yazma özelliklerini destekler. Daha fazla bilgi için bkz. JSON ve Atom veri biçimleri. |
| Groups Settings API, etkinleştirme | Groups Settings API'ye çağrı yapmadan önce Directory API'yi etkinleştirmeniz gerekir. Google Workspace API'lerini etkinleştirme başlıklı makaleyi inceleyin. |