Sınırlar ve kotalar, Google altyapısını Admin Settings API'yi uygunsuz şekilde kullanan otomatik bir işlemden korur. Bir API'den gelen çok fazla istek, zararsız bir yazım hatasından veya gereksiz API çağrıları yapan, verimsiz bir şekilde tasarlanmış bir sistemden kaynaklanıyor olabilir. Nedeni ne olursa olsun, belirli bir kaynağa gelen trafiğin engellenmesi, Google Workspace sisteminin genel durumu için gereklidir. Bir geliştiricinin işlemlerinin geniş topluluğu olumsuz şekilde etkilememesini sağlar.
Gerçekleşmemesi durumunda API isteğiniz başarısız olursa HTTP durum kodu yanıtı alırsınız. 403 durum kodunda, yanlış girişle ilgili hata bilgileri mevcut ve HTTP durum kodu 503'te hangi API kotalarının aşıldığını belirten hata bilgileri var. Bu yanıtlar, özel uygulamanızın bu hataları algılayıp gerekli işlemleri 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 ileti dizisi kullanın. Örneğin, isteklerinizi aya veya başka bir döneme göre gruplandırın. Mesaj dizilerinde, her istek için bir mesaj dizisi olan 10 ileti dizisiyle başlamayı deneyin. İleti dizisi önerisinin dezavantajları olduğunu ve tüm API durumları için yararlı olmadığını unutmayın. İstek sayısı çok fazla olursa kota hataları oluşur.
Zamana dayalı (mesaj dizisi başına en fazla X saniye boyunca) tüm hatalar için (özellikle 503 durum kodu hataları için) kodunuzun istisnayı yakalamasını ve üstel geri çekilme algoritması kullanarak başarısız aramayı tekrar denemeden önce küçük bir gecikme beklemenizi öneririz. Bir ileti dizisi için E-posta Ayarları API'sine örnek olarak, 5 saniye bekleyip başarısız aramayı yeniden denemektir. İstek başarılı olursa diğer mesaj dizileri için bu kalıbı tekrar edin. İkinci istek başarılı değilse uygulamanız, bir arama başarılı olana kadar isteğin sıklığına göre tekrar ölçeklendirme yapmalıdır. Örneğin, ilk 5 saniyelik gecikmeyi 10 saniyeye yükseltin ve başarısız 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 isteği farklı gecikme süreleriyle 5-7 kez yeniden deneyin.
| API Kota Kategorileri | Kotalar |
|---|---|
| ClientLogin kimlik doğrulama jetonları | 24 saat geçerlidir. "401 jetonunun süresi doldu" hatası görüntülenir. |
| Ortak ve özel anahtar oluşturma | Kimlik sağlayıcınızla, DSA veya RSA algoritmalarını kullanarak bir dizi ortak ve özel anahtar oluşturun. Ortak anahtar, X.509 biçiminde bir sertifikadır. SAML tabanlı Tek Oturum Açma imzalama anahtarları hakkında daha fazla bilgi edinmek üzere Google Workspace Tek Oturum Açma Hizmeti için Anahtar ve Sertifika Oluşturma başlıklı makaleyi inceleyin. |
| Logo | Hesabın logo resmi dosyası JPEG, PNG veya GIF biçiminde olabilir. Önerilen boyut 143 x 59 pikseldir ve dosya 20 Kb'tan küçük olmalıdır. Özel logoları kullanırken Google Hizmet Şartları'na uymayı unutmayın. Ayrıca Google logosunu, Gmail logosunu veya diğer Google logolarını kullanmaktan kaçının. Daha fazla bilgi için Logo ve açılış sayfası politikaları konusuna bakın. |
| ssoBeyaz Liste | ssoBeyaz Ortam, Sınıfsız Alanlar Arası Yönlendirme (CIDR) biçiminde bir ağ maskesi IP adresidir. |
| Diğer Sınır Türleri | Sınırlamalar ve Kurallar |
|---|---|
| MX kaydı doğrulama durumu | Varsayılan MX kaydı doğrulama durumu "false" (yanlış) şeklindedir. Bu, Google sisteminin MX kaydı yapılandırmanızı yakın zamanda kontrol etmediği veya MX kayıtlarınızın Google sistemlerine işaret edecek şekilde yapılandırılmadığı anlamına gelir. Kayıtlarınızı güncellediyseniz ve doğrulama durumu yanlışsa MX kaydı güncellemeleriniz yayılmamış olabilir veya kayıtta bir yazım hatası vardır. Yayılma için MX kaydının Geçerlilik Süresi (TTL) ile tanımlanan süreyi beklemeniz ve yeniden denemeniz önerilir. |
| Ülke kodları | Kuruluş adı özelleştirilmediyse varsayılan olarak birincil alan adınız kullanılır. Kuruluş adı karakterleri hakkında bilgi edinmek için Karakter kullanımı başlıklı makaleye bakın. |
creationTime özelliği, tarih ve saatin sayısal temsili |
Tarih ve Saatin sayısal gösterimi olan ISO 8601'e bakın. |
| Dil kodlama etiketleri | Google Mail tarafından kabul edilen RFC 3066 dil etiketlerine bakın. |
| Kuruluş adı | Kuruluş adı özelleştirilmediyse varsayılan olarak birincil alan adınız kullanılır. Kuruluş adı karakterleri hakkında bilgi edinmek için Karakter kullanımı başlıklı makaleye bakın. |