Sınırlar ve kotalar, Google altyapısını E-posta Denetimi 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ığında engellenmesi, Google Workspace sisteminin genel sağlığı için gereklidir. Sınırlar, bir geliştiricinin işlemlerinin daha büyük topluluğu olumsuz etkilememesini sağlamaya yardımcı olur.
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ığı olacak şekilde 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. Başka bir denge örneği, maksimum genel ileti yükleme hızı için Email Audit API'nin kotasıdır. Yükleme isteği gönderen iş parçacığı sayısı ne olursa olsun, yükleme hızı kullanıcı başına saniyede bir API isteğidir.
Zamana dayalı tüm hatalar (iş parçacığı başına N 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 Audit API örneği, 5 saniye bekleyip başarısız olan çağrıyı yeniden denemektir. İstek başarılı olursa diğer iş parçacıkları için bu işlemi 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 aramanı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.
Aşağıdaki tabloda, Email Audit API'nin sınırları listelenmektedir:
| API sınır kategorileri | Sınırlar |
|---|---|
| Şifrelenmiş posta kutusu dosyaları, oluşturma |
Şifrelenmiş posta kutusu dosyalarının oluşturulması, boyutuna bağlı olarak sistemin hazırlanması için birkaç gün sürebilir. |
| Şifrelenmiş posta kutusu dosyaları, silmeyle ilgili hatalar |
Şifrelenmiş bir posta kutusu silinirken hata oluştuğunda isteğe |
Aşağıdaki tabloda Email Audit API'nin kotaları listelenmiştir:
| API kota kategorileri | Kotalar |
|---|---|
| ClientLogin kimlik doğrulama jetonları |
24 saat geçerlidir. Hata: |
| Tarih biçimleri |
E-posta Denetimi API'si ile kullanmadan önce tüm tarihleri Eşgüdümlü Evrensel Saat (UTC) biçimine dönüştürün. Daha fazla bilgi için UTC dönüştürücü başlıklı makaleyi inceleyin. |
|
Şifrelenmiş posta kutusu dosyaları, |
Google, şifrelenmiş posta kutusu dosyalarını 3 hafta boyunca saklar. Bu sürenin sonunda silinirler. Bu süre zarfında bu posta kutusu dosyalarını indirmek alan yöneticisinin sorumluluğundadır. |
| Şifrelenmiş posta kutusu dosyaları, biçim |
Şifrelenmiş posta kutusu dosyaları mbox biçimindedir. |
| Şifrelenmiş posta kutusu dosyaları, maksimum oluşturma isteği sayısı |
Günlük maksimum posta kutusu dışa aktarma oluşturma isteği sayısı, etki alanındaki tüm yöneticilerden gelen toplam 100 istektir. |
| Şifrelenmiş posta kutusu dosyası durumu, sayfalara ayırma |
Tüm posta kutusu isteklerinin durumu istendiğinde yanıtlar büyük miktarda veri döndürebilir. Email Audit API, bu verileri her biri en fazla 100 giriş içeren sayfalar halinde gruplandırır ve |
| E-posta izleme |
Günlük maksimum e-posta izleme isteği sayısı 1.500'dür. Bu sınır, alan adı için geçerlidir ve gün içinde herhangi bir yönetici tarafından yapılan tüm istekleri içerir. |
| Ortak anahtar |
Email Audit API yalnızca bir anahtarı destekler. Ortak anahtar, GNU Privacy Guard (GPG) yazılımını kullanır. PGP biçimindedir ve ASCII kodlu bir RSA şifreleme anahtarıdır. Ortak anahtarı yüklemeden önce base64 kodlu bir dizeye dönüştürmeniz gerekir. Ortak anahtar dosyası, karakter kümesiyle okunmalıdır: US-ASCII, (IANA ASCII için tercih edilen karakter kümesi adı). |
| Arama |
|