Sınırlar ve kotalar, Google altyapısını, Groups Settings API'yi uygun olmayan bir şekilde kullanan otomatik bir işlemden 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ığında engellenmesi, Google Workspace sisteminin genel durumu için gereklidir.
API isteği hataları
Çok düşük bir ihtimalle de olsa API isteğinizin başarısız olması durumunda uygulamanız bir HTTP durum kodu yanıtı alır. 403
HTTP durum kodunda, hangi API kotalarının aşıldığını belirten hata bilgileri bulunuyor. Bu yanıt özel uygulamanızın hataları algılayıp uygun işlemi gerçekleştirmesini sağlar.
Zamana duyarlı istekler
İsteklerinizin sabit 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. Örneğin, isteklerinizi aya veya başka bir döneme göre bölebilirsiniz. İ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ı ödünler içerir ve tüm API durumları için faydalı değildir. İstek sayısı çok yükselirse kota hataları ortaya çıkar.
Zamana dayalı hatalar
Süreye dayalı tüm hatalar (iş parçacığı başına X saniye için en fazla N şey), özellikle 503
durum kodu hataları için kodunuzun istisnayı yakalamasını ve üstel geri yükleme algoritması kullanarak başarısız çağrıyı yeniden denemeden önce kısa bir süre beklemenizi öneririz. Bir iş parçacığı için Groups Settings API'ye örnek olarak 5 saniye bekleyip başarısız çağrıyı yeniden deneyin. İstek başarılı olursa diğer iş parçacıkları için bu kalıbı tekrarlayın. İkinci istek başarılı olmazsa uygulamanız, bir arama başarılı olana kadar isteğin sıklığını aşağı ölçeklendirmelidir. Örneğin, ilk 5 saniyelik gecikmeyi 10 saniyeye yükseltin ve başarısız olan çağrıyı tekrar deneyin. Ayrıca bir yeniden deneme sınırı belirleyin. Örneğin, uygulamanız kullanıcıya hata döndürmeden önce bir isteği farklı gecikme süreleriyle 5-7 kez yeniden deneyin.
Kotalar
API kota kategorileri | Kotalar |
---|---|
Günlük sorgu sayısı | Günde en fazla 100.000 sorgu oluşturabilirsiniz. Bu sınırın üzerinde kapasiteye ihtiyaç duyarsanız Google Cloud Console'daki Kotalar sayfasından istek gönderebilirsiniz |
Grup açıklaması, maksimum boyut | En fazla 300 karakterden oluşan bir grup açıklaması girebilirsiniz. |
Grup adı, maksimum boyut | Bir grup adı en fazla 60 karakterden oluşabilir. |
defaultMessageDenyNotificationText |
Bildirim metni en fazla 10.000 karakter uzunluğunda olabilir. defaultMessageDenyNotificationText özelliği hakkında daha fazla bilgi edinmek için API referansına bakın.
|
maxMessageBytes |
Varsayılan maksimum ileti boyutu 1 MB'tır. maxMessageBytes özelliği hakkında daha fazla bilgi edinmek 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. Hem JSON hem de Atom veri biçimleri tam okuma-yazma özelliklerini destekler. Daha fazla bilgi için JSON ve Atom veri biçimleri bölümünü inceleyin. |
Groups Settings API, etkinleştirme | Groups Settings API'ye çağrı yapmadan önce Directory API'yi etkinleştirmeniz gerekir. Daha fazla bilgi için Google Workspace API'lerini etkinleştirme başlıklı makaleyi inceleyin. |