Sınırlar ve kotalar, Google altyapısını Reports API'yi uygun olmayan bir şekilde kullanan otomatik bir işlemden korur. Bir API'den gelen aşırı sayıda istek, zararsız bir yazım hatasından veya gereksiz API çağrıları yapan, verimsiz bir şekilde tasarlanmış bir sistemden kaynaklanabilir. Nedeni ne olursa olsun, belirli bir kaynaktan gelen trafiğin belirli bir düzeye ulaştıktan sonra engellenmesi, Google Workspace sisteminin genel durumu için gereklidir. Bir geliştiricinin eylemlerinin büyük topluluğu olumsuz etkilememesini sağlar.
Çok düşük bir ihtimalle 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 ise hangi API kotalarının aşıldığını belirten hata bilgileri bulunur. Bu yanıtlar, özel uygulamanızın bu hataları algılamasına ve uygun 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 gruplar halinde e-posta talep etmek verilebilir. İleti dizileri söz konusuysa, her kullanıcı e-postası için bir ileti dizisi olacak şekilde 10 ileti dizisiyle başlamayı deneyin. İş parçacığı önerisinin bazı eksileri olduğunu ve tüm API durumları için faydalı 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 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 Reports API'ye örnek, 5 saniye bekleyip başarısız çağrıyı yeniden denemektir. İstek başarılı olursa diğer ileti dizileri için de bu kalıbı tekrarlayın. İkinci istek başarılı değilse uygulamanız, bir çağrı başarılı olana kadar isteğin sıklığına göre tekrar ölçeklendirmelidir. Örneğin, ilk 5 saniyelik gecikmeyi 10 saniyeye yükseltin ve 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 deneyin.
| API Sınır Kategorileri | Sınırlar |
|---|---|
| QPS ve QPD oranlarını raporla | API, Google Cloud projenize yönelik istek sayısını sınırlar.
Google Cloud Console'da ayarlanan varsayılan değer,her Google Cloud projesi için kullanıcı başına dakikada 2.400 sorgudur.
Bu sınırı Google Cloud projenizin Admin SDK API Kotaları sayfasından artırabilirsiniz.
Bu sınırlar aşılırsa sunucu bir HTTP 503 durum kodu döndürür. İsteklerinizi yeniden denerken üstel geri yükleme algoritmasını kullanın. |
| API Kota Kategorileri | Kotalar |
| maks.Sonuçlar | Bir API'nin yanıtının her sayfasında listelenen kayıt sayısı 1 ile 1.000 etkinlik arasındadır. Varsayılan değer 1.000 kayıttır. |
| Diğer 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. |
| Yetkisiz istekler | Google, API'ye yetkisiz istekler yapılmasına izin vermez. Yetkilendirme jetonu sağlanmazsa istek yetkisiz olarak kabul edilir. Daha fazla bilgi için İstekleri yetkilendirme başlıklı makaleye bakın. |
| Uyarı mesajları |
|