Sınırlar ve kotalar, Google altyapısını Enterprise License Manager API'yi uygun olmayan ş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 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. Bir geliştiricinin eylemlerinin topluluk üzerinde olumsuz bir etki yaratmamasını sağlar.
Çok düşük bir ihtimal de olsa API isteğinizin başarısız olması durumunda bir HTTP durum kodu yanıtı alırsınız. 403 durum kodunda yanlış girişle ilgili hata bilgileri yer alır. HTTP durum kodunda ise hangi API kotalarının aşıldığını belirten hata bilgileri bulunur. Bu yanıtlar, özel uygulamanızın bu hataları algılayıp gerekli işlemi yapmasına olanak tanır.
İsteklerinizin belirli bir süre içinde tamamlanması gerekiyorsa istekleri toplu olarak gönderin. API'nizin amacına bağlı olarak ve istek sayısı çok yükselirse kota hataları oluşur.
Önerilen API toplu istekleri özelliğini kullanamıyorsanız eksponansiyel geri yükleme algoritmasını kullanın. Zamana dayalı tüm hatalar (iş parçacığı başına X saniyede en fazla N öğe), ö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 Enterprise License Manager API örneği, 5 saniye bekleyip başarısız çağrıyı yeniden denemektir. İstek başarılı olursa diğer ileti dizileri 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ığına geri dönmelidir. Örneğin, ilk 5 saniyelik gecikmeyi 10 saniyeye çıkararak başarısız olan aramanızı 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 deneyebilirsiniz.
| API Kota Kategorileri | Kotalar |
|---|---|
| Saniyedeki sorgu sayısı (QPS) | QPS kotası 1'dir. |
| API Sınır Kategorileri | Sınırlar |
|---|---|
| maxResults sorgu dizesi | MaxResults öğelerinin maksimum boyutu 100'dür. |
| Diğer Sınır Türleri | Sınırlamalar ve Kurallar |
|---|---|
| Toplu istekler |
API, toplu isteklerin gönderilmesini destekler. |
| API yanıtlarındaki veri biçimi | Yanıtın veri biçimi JavaScript Object Notation (JSON) şeklindedir. |
| Enterprise License Manager API'yi etkinleştirme | Enterprise License Manager API'ye çağrı yapılmadan önce Temel Hazırlık API'sının etkinleştirilmesi gerekir. Kontrol panelinizde Kullanıcılar ve gruplar sekmesinin Ayarlar sayfasına gidin ve Konfigürasyon API'sını etkinleştirin. Değişikliklerinizi kaydedin. Ayrıca, Google Grupları hizmetinin etkinleştirilmesi ve etkinleştirilmesi gerekir. |
| Yetkisiz istekler | API, yetkisiz istekleri kabul etmez. Yetkilendirme jetonu sağlanmazsa istekler yetkisiz olarak değerlendirilir. Daha fazla bilgi için İstekleri Yetkilendirme bölümüne bakın. |