Sınırlar ve kotalar, Google altyapısını E-posta Denetim API'sini uygunsuz biçimde kullanan otomatik bir işlemden korur. Bir API'den gelen çok fazla istek, zararsız bir yazım hatasından veya gerekli olmayan API çağrıları yapan, verimsiz bir şekilde tasarlanmış bir sistemden kaynaklanıyor olabilir. Nedeni ne olursa olsun, belirli bir kaynağa ulaşan belirli bir kaynaktan gelen trafiğin Google Workspace sisteminin genel durumu için engellenmesi gerekir. Sınırlar, bir geliştiricinin eylemlerinin daha büyük bir topluluğu olumsuz yönde etkilemesine engel olur.
Çok düşük ihtimalle de olsa API isteğiniz başarısız olursa HTTP durum kodu yanıtı alırsınız. 403 durum kodu, hatalı girişle ilgili hata bilgilerine ve 503 durum kodu, hangi API kotalarının aşıldığını belirten hata bilgilerine sahiptir. Bu yanıtlar, özel uygulamanızın bu hataları tespit etmesini ve uygun işlemi gerçekleştirmesini sağlar.
İsteklerinizin belirli bir süre içinde tamamlanması gerekiyorsa isteklerinizi paralel olarak gönderin veya Java ya da C# uygulamanızda birden fazla ileti dizisi kullanın. Paralel isteklere örnek olarak, bir kullanıcıdan aynı anda çok sayıda e-posta adresi eklemek veya kaldırmak yerine farklı kullanıcılardan küçük e-posta grupları istemek verilebilir. İleti dizileri söz konusu olduğunda, kullanıcı e-posta adresi başına bir ileti dizisi olan 10 ileti dizisiyle başlayın. İleti dizisi önerisinin dezavantajları olduğunu ve tüm API durumları için yararlı olmadığını unutmayın. İstek sayısı çok yüksekse kota hataları oluşur. Başka bir denge örneği de E-posta Denetim API'si için maksimum genel ileti yükleme hızı kotasıdır. Yükleme hızı, kaç mesaj dizisinde istek yapıldığına bakılmaksızın kullanıcı başına saniyede bir API isteğidir.
Zamana dayalı (ileti dizisi başına N saniye boyunca maksimum N öğe) tüm hatalar için (özellikle de 503 durum kodu hataları nedeniyle) kodunuzun istisnayı yakalamasını ve başarısız aramayı yeniden denemeden önce üstel geri çekilme algoritması kullanarak küçük bir gecikme olmasını öneririz. Bir ileti dizisi için E-posta Denetim API'sı örneği, 5 saniye bekleyip başarısız aramayı yeniden denemektir. İstek başarılı olursa diğer mesaj dizileri için bu kalıbı tekrarlayın. İkinci istek başarılı değilse uygulamanız, bir arama başarılı olana kadar isteğin sıklığına göre tekrar ölçeklendirme yapmalıdır.
Örneğin, ilk 5 saniyelik gecikmeyi 10 saniyeye yükseltin ve başarısız aramanızı tekrar deneyin. Ayrıca, bir yeniden deneme sınırı belirleyin. Örneğin, uygulamanız kullanıcıya bir hata döndürmeden önce isteği farklı bir gecikme süresiyle 5-7 kez yeniden deneyin.
Aşağıdaki tabloda, Email Audit API sınırları gösterilmektedir:
| API sınırı kategorileri | Sınırlar |
|---|---|
| Şifrelenmiş posta kutusu dosyaları, oluşturma | Şifrelenmiş posta kutusu dosyalarının oluşturulması, sistemin boyutuna bağlı olarak birkaç gün sürebilir. |
| Şifrelenmiş posta kutusu dosyaları, silmeyle ilgili hatalar | Şifrelenmiş bir posta kutusunu silme işlemi gerçekleştiğinde ve hatalar oluştuğunda, isteğe MARKED_DELETE durumu atanır. Bu özetler ve dışa aktarma dosyaları Google tarafından 24 saat içinde otomatik olarak tekrar silinir (kalan dosyalarla birlikte). MARKED_DELETE durumu sürekli olarak döndürülürse üstel geri çekilme stratejisini deneyin.
|
Aşağıdaki tabloda, Email Audit API için kotalar listelenmiştir:
| API kota kategorileri | Kotalar |
|---|---|
| ClientLogin kimlik doğrulama jetonları | 24 saat geçerlidir. Hata: 401 token expired
|
| Tarih biçimleri | Tüm tarihleri E-posta Denetim API'si ile kullanmadan önce Eşgüdümlü Evrensel Zaman (UTC) biçimine dönüştürün. Daha fazla bilgi için UTC dönüştürücü bölümüne bakın. |
Şifrelenmiş posta kutusu dosyaları, EXPIRED özet ve dışa aktarma dosyaları
|
Google, şifrelenmiş posta kutusu dosyalarını 3 hafta boyunca saklar. Bu sürenin sonunda silinirler. Bu süre içinde 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ı, alandaki tüm yöneticilerin toplam 100 isteğidir. |
| Şifrelenmiş posta kutusu dosya 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 bir sayfada maksimum 100 giriş ve bir sonraki sonuç sayfasını işaret eden link rel='next' etiketinde bir URI içeren sayfalar halinde gruplandırır. İstemci uygulamanızı geliştirirken kodunuzun bu ek sonuçları yönetmesi gerekir.
|
| Monitöre e-posta gönder | Günlük maksimum e-posta izleme isteği sayısı 1500'dür. Bu sınır alan 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 kodlamalı bir RSA şifreleme anahtarıdır. Ortak anahtarı yüklemeden önce, anahtarı base64 kodlu bir dizeye dönüştürmeniz gerekir. Ortak anahtar dosyası, US-ASCII karakter kümesi (ASCII için IANA tercih edilen karakter kümesi) ile okunmalıdır. |
| Aranıyor | searchQuery ve includeDeleted parametreleri karşılıklı olarak birbirini dışlar. includeDeleted="true" ise arama sorgusu yapılamaz.
|