Kullanım sınırları ve kotalar

Sınırlar ve kotalar, Google altyapısını, Uyarı Merkezi API'sini 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 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 bilgisi ve 503 HTTP durum kodunda hangi API kotalarının aşıldığını belirten hata bilgisi bulunuyor. Bu yanıtlar, özel uygulamanızın bu hataları algılayıp gerekli işlemi yapmasına olanak tanır.

İ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. Paralel isteklere örnek olarak, bir kullanıcıdan aynı anda çok sayıda e-posta eklemek veya kaldırmak yerine farklı kullanıcılardan küçük e-postalar grupları istenmesi verilebilir. İleti dizileri söz konusuysa, kullanıcı e-postası başına bir ileti dizisi olacak şekilde 10 ileti dizisiyle başlamayı deneyin. İş parçacığı önerisinin bazı avantajları olduğunu ve tüm API durumları için uygun olmadığını unutmayın. İstek sayısı çok yükselirse kota hataları oluşur.

Zamana dayalı tüm hatalar (iş parçacığı başına N 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. Uyarı Merkezi API'sine örnek olarak 5 saniye bekleyip başarısız çağrıyı yeniden denemek verilebilir. İ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 Sınır Kategorileri Sınırlar
Uyarı Merkezi QPS ve QPD ücretleri API, API Konsolu projeniz için istek sayısını sınırlar. API projesinin saniyedeki maksimum istek sayısı (proje QPS) 1.000'dir. Ayrıca kullanıcı başına saniyede maksimum istek sayısı (kullanıcı QPS'si) 150'dir.

Bu sınırlar aşılırsa sunucu bir HTTP 503 durum kodu döndürür. İsteklerinizi yeniden denerken eksponansiyel geri yükleme algoritmasını kullanın.

Diğer Sınır Türleri Sınırlamalar ve Kurallar
Veri biçimi, varsayılan Varsayılan veri biçimi JSON'dir.
Yetkisiz istekler Google, bu API'ye yetkisiz istekler yapılmasına izin vermez. Yetkilendirme jetonu sağlanmazsa istekler yetkisiz olarak değerlendirilir. Daha fazla bilgi için İstekleri yetkilendirme başlıklı makaleye bakın.

Proje başına kota artışı isteme

Projenizin kaynak kullanımına bağlı olarak kota artışı talep edebilirsiniz. Bir hizmet hesabından yapılan API çağrıları, tek bir hesap kullanıyor olarak kabul edilir. Kota artışı için başvurmak, onay alacağınızı garanti etmez. Büyük kota artışlarının onaylanması daha uzun sürebilir.

Her projenin kotası aynı değildir. Google Cloud'u zaman içinde gitgide daha fazla kullandığınız için kotalarınızın da artması gerekebilir. Kullanımın önemli oranda artacağını düşünüyorsanız Google Cloud Console'daki Kotalar sayfasından önlem amaçlı olarak kotaların ayarlanmasını isteyebilirsiniz.

Daha fazla bilgi edinmek için aşağıdaki kaynakları inceleyin: