Kullanım sınırları ve kotalar

Sınırlar ve kotalar, Google altyapısını Yönetici Ayarları 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 kaynaktan gelen trafiği belirli bir düzeye ulaştığında engellemek, Google Workspace sisteminin genel sağlığı için gereklidir. Bir geliştiricinin eylemlerinin daha büyük topluluğu olumsuz etkilememesini sağlar.

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 içerir. 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. Örneğin, isteklerinizi aya veya başka bir zaman aralığına göre ayırın. İleti dizileri için her istekte bir ileti dizisi olacak şekilde 10 ileti dizisiyle başlamayı deneyin. İş parçacığı önerisinin dezavantajları olduğunu ve tüm API durumlarında kullanışlı olmadığını unutmayın. İstek sayısı çok yükselirse kota hataları oluşur.

Zamana dayalı tüm hatalar (iş parçacığı başına X saniyede en fazla N öğe) için, özellikle 503 durum kodu hataları 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 ileti dizisi için Email Settings 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 iş parçacıkları için 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 çağrınızı tekrar deneyin. Ayrıca, yeniden deneme sınırı belirleyin. Örneğin, uygulamanız kullanıcıya hata döndürmeden önce farklı gecikme süreleriyle bir isteği 5-7 kez yeniden deneyin.

API Kota Kategorileri Kotalar
ClientLogin kimlik doğrulama jetonları 24 saat geçerlidir. Hata "401 token expired" (401 jetonun süresi doldu) şeklindedir.
Genel ve özel anahtarlar oluşturma

Kimlik sağlayıcınızla birlikte DSA veya RSA algoritmalarını kullanarak bir dizi ortak ve özel anahtar oluşturun. Ortak anahtar, X.509 biçimli sertifikadadır. SAML tabanlı Tek Oturum Açma imzalama anahtarları hakkında daha fazla bilgi için Google Workspace Tek Oturum Açma Hizmeti için Anahtar ve Sertifika Oluşturma başlıklı makaleyi inceleyin.
Logo

Bir hesabın logo resim 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 Google'a ait herhangi bir logoyu kullanmaktan kaçının. Daha fazla bilgi için Logo ve açılış sayfası politikaları başlıklı makaleyi inceleyin.
ssoWhitelist

ssoWhitelist, 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 Yönergeler
MX kaydı doğrulama durumu

Varsayılan MX kaydı doğrulama durumu "false"tur. Bu, Google sisteminin MX kaydı yapılandırmanızı yakın zamanda kontrol etmediği veya MX kayıtlarınızın Google sistemlerini işaret edecek şekilde yapılandırılmadığı anlamına gelir. Kayıtlarınızı güncellediyseniz ve doğrulama durumu yanlış olarak kalmaya devam ediyorsa MX kaydı güncellemelerinizin yayılmadığı veya kayıtta yazım hatası olduğu anlamına gelebilir. Yayılma için, MX kaydının Time To Live (TTL) değeriyle tanımlanan süre kadar beklemenizi ve tekrar denemenizi öneririz.
Ü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ı makaleyi inceleyin.
creationTime özelliği, tarih ve saatin sayısal gösterimi

Tarih ve saatin sayısal gösterimi için ISO 8601'e bakın.
Dil kodlama etiketleri

Google Mail'in kabul ettiği RFC 3066 dil etiketlerini inceleyin.
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ı makaleyi inceleyin.

Proje başına kota artışı isteğinde bulunma

Projenizin kaynak kullanımına bağlı olarak kota ayarlaması isteğinde bulunabilirsiniz. Bir hizmet hesabı tarafından yapılan API çağrıları, tek bir hesap kullanı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 artması gerekebilir. Kullanımın önemli oranda artacağını düşünüyorsanız Google Cloud Console'daki Kotalar sayfasından önlem amaçlı olarak kota ayarlamaları isteyebilirsiniz.

Daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın: