Mail Admin Quarantine API kullanım kotaları

Mail Admin Quarantine API, karantinaya alınmış iletileri arayan ve alan Google Workspace altyapısını korumak için her Google Cloud projesinde dakika başına kullanım kotaları uygular. Kotalar, bir yöntemin gerçekleştirdiği iş türüne göre gruplandırılır.

Kotalar

Aşağıdaki tabloda kotalar listelenmiştir. Her kota dakika başına ve Cloud projesi başına belirlenir. Projenin tüm Google Workspace müşterileri ve kimliğine bürünülen yöneticiler genelinde yaptığı tüm istekler sayılır.

Kota Değer Yöntemler
Arama ve listeleme istekleri Dakikada 60 istek customers.quarantinedMessages.list, customers.quarantinedMessages.search
Okuma istekleri Dakikada 1.200 istek customers.quarantinedMessages.get, customers.quarantines.get, customers.quarantines.list, customers.operations.get
Yazma istekleri Dakikada 300 istek customers.quarantinedMessages.release, customers.quarantinedMessages.deny, customers.quarantinedMessages.batchRelease, customers.quarantinedMessages.batchDeny

Sayfa boyutundan veya toplu yöntemler için gruptaki mesaj sayısından bağımsız olarak her API çağrısı bir istek olarak sayılır. Örneğin, 500 mesaj içeren bir batchRelease isteği bir yazma isteği tüketir.

Projenizin mevcut kota kullanımını Google Cloud Console'da API'ler ve Hizmetler > Etkin API'ler ve hizmetler > Admin Quarantine API > Kotalar ve Sistem Sınırları bölümünde görüntüleyebilirsiniz.

İstek kısıtlamaları

Kısıtlama Değer
list ve search istekleri için maksimum pageSize 300 mesaj
batchRelease veya batchDeny isteği başına maksimum mesaj sayısı 500 mesaj
Arama ve liste penceresi Son 30 gün içinde alınan mesajlar

Kota hatalarını çözme

Projeniz bir kotayı aştığında API, RESOURCE_EXHAUSTED durumuna sahip bir HTTP 429 hatası döndürür:

{
  "error": {
    "code": 429,
    "message": "Quota exceeded for quota metric 'Search and list quarantined messages requests' and limit 'Search and list requests per minute per project' of service 'mailadminquarantine.googleapis.com' for consumer 'project_number:123456789012'.",
    "status": "RESOURCE_EXHAUSTED"
  }
}

Kotaları aşmamak için:

  • Eksponansiyel geri yüklemeyle yeniden deneme yapılıyor. 429 hatası aldığınızda yeniden denemeden önce bekleyin ve her başarısız denemeden sonra bekleme süresini artırın. Ayrıntılı bilgi için Eksponansiyel geri yükleme başlıklı makaleyi inceleyin.
  • Kullanışlı en büyük sayfa boyutunu kullanın. Arama ve listeleme istekleri en küçük kotaya sahiptir. Çok sayıda küçük sayfa yerine sayfa başına en fazla 300 mesaj isteyin.
  • Filtreleri kullanın. Yalnızca ihtiyacınız olan mesajları almak için search isteklerini filter veya query ile daraltın.
  • Toplu işlemler için toplu yöntemleri kullanın. Tek bir batchRelease veya batchDeny isteği, 500'e kadar iletiyi serbest bırakabilir veya reddedebilir. release ya da deny çağrısı başına ise yalnızca bir ileti serbest bırakılabilir veya reddedilebilir.
  • İşlemleri seyrek olarak yoklayın. Toplu işlem için beklerken customers.operations kaynağının get yöntemini sürekli olarak değil, birkaç saniyede bir çağırın.
  • Kademeli olarak senkronize edin. Her çalıştırmada tüm karantinayı yeniden listelemek yerine status = PENDING_TRIAGE'e göre filtreleyin ve yalnızca yeni mesajları işleyin.

Geliştirici Önizlemesi sırasında kota artışı yapılamaz. Kullanım alanınız daha yüksek kotalar gerektiriyorsa geri bildiriminizi Google Workspace Geliştirici Önizleme Programı aracılığıyla paylaşın.