Sınırlar ve kotalar, Google altyapısını Raporlar 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ğin belirli bir düzeye ulaştıktan sonra engellenmesi, Google Workspace sisteminin genel sağlığı için gereklidir. Bir geliştiricinin işlemlerinin daha büyük topluluğu olumsuz etkilemesini önler.
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, 503 HTTP durum kodu ise hangi API kotalarının aşıldığını gösteren 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. Paralel isteklere örnek olarak, tek bir kullanıcıdan çok sayıda e-posta eklemek veya kaldırmak yerine farklı kullanıcılardan küçük e-posta grupları istemek verilebilir. İş parçacıkları söz konusu olduğunda, kullanıcı e-postası başına bir iş parçacığı olmak üzere 10 iş parçacığıyla başlamayı deneyin. İş parçacığı önerisinin dezavantajları olduğunu ve tüm API durumlarında yararlı 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 öğ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. A Bir iş parçacığı için Reports 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 bir isteği farklı gecikme süreleriyle 5 ila 7 kez yeniden deneyin.
Sınırlar
| API Sınır Kategorileri | Sınırlar |
|---|---|
| QPS ve QPD oranlarını raporlama | API, Google Cloud projeniz için istek sayısını sınırlar.
Google Cloud Console'da ayarlanan varsayılan değer,Google Cloud projesi başına kullanıcı başına dakikada 2.400 sorgudur. Bu sınırı Google Cloud projenizin Admin SDK API Kota sayfasından artırabilirsiniz.
Bu sınırlar aşılırsa sunucu, HTTP 503 durum kodu döndürür. İsteklerinizi yeniden denerken eksponansiyel geri yükleme algoritmasını kullanın. |
activities.list için ek sınırlar |
activities.list API'nin ek olarak dakikada 250 filtre sorgusu (saatte 15.000 filtre sorgusu) sınırı vardır. Filtre sorgusu,
aşağıdaki sorgu parametrelerinden en az birini içeren bir API isteğidir:
|
| API Kota Kategorileri | Kotalar |
| maxResults | Bir API'nin yanıtının her sayfasında listelenen kayıt sayısı 0 ile 1.000 arasındadır. Varsayılan değer 1.000 kayıttır. |
Diğer Sınır Türleri
| Diğer Sınır Türleri | Sınırlamalar ve Yönergeler |
|---|---|
| Veri biçimi, varsayılan | Varsayılan veri biçimi JSON'dur. API, Atom biçimini de destekler. |
| Yetkisiz istekler | Google, API'ye yetkisiz istek gönderilmesine izin vermez. Yetkilendirme jetonu sağlanmazsa istek yetkisiz olarak kabul edilir. Daha fazla bilgi için İstekleri yetkilendirme başlıklı makaleyi inceleyin. |
| Uyarı mesajları |
|
activities.list için en iyi uygulamalar
Denetim incelemeleri için activities.list yönteminin kullanılması beklenir. En iyi performansı elde etmek için startTime ve endTime parametrelerini kullanarak isteğinizde bir zaman aralığı bulunmalıdır. Daha dar zaman aralıkları, yanıt sürelerinin önemli ölçüde kısalmasını sağlar. Bu yöntem, denetleme günlüklerinin yüksek hacimli olarak alınması için tasarlanmamıştır. activities.list filtre isteği kotanızı düzenli olarak tüketiyorsanız aşağıdaki seçenekleri değerlendirin:
- Google Workspace günlüklerinin BigQuery'ye aktarılmasını ayarlayın ve ihtiyacınız olan verileri API kota kısıtlamaları olmadan almak ve analiz etmek için BigQuery'nin güçlü sorgu API'lerini kullanın.
- Filtre istekleri kullanmak yerine, zaman aralığı içeren filtre dışı istekler kullanın ve istemci tarafı filtreleme gerçekleştirin (ör. filtreleme mantığını uygulamanızda yapın). Bu sayede,dakikada 250 filtre sorgusu sınırını aşabilirsiniz ancak kullanıcı başına Google Cloud projesi başına dakikada 2.400 sorgu sınırına tabi olmaya devam edersiniz.