Nutzungskontingente für die Mail Admin Quarantine API

Die Mail Admin Quarantine API erzwingt Nutzungskontingente pro Minute für jedes Google Cloud-Projekt, um die Google Workspace-Infrastruktur zu schützen, die Nachrichten in Quarantäne sucht und abruft. Die Kontingente werden nach der Art der Arbeit gruppiert, die eine Methode ausführt.

Kontingente

In der folgenden Tabelle sind die Kontingente aufgeführt. Jedes Kontingent gilt pro Minute und Cloud-Projekt. Es werden alle Anfragen gezählt, die das Projekt für alle Google Workspace-Kunden und imitierten Administratoren stellt.

Kontingent Wert Methoden
Such- und Listenanfragen 60 Anfragen pro Minute customers.quarantinedMessages.list, customers.quarantinedMessages.search
Leseanfragen 1.200 Anfragen pro Minute customers.quarantinedMessages.get, customers.quarantines.get, customers.quarantines.list, customers.operations.get
Schreibanfragen 300 Anfragen pro Minute customers.quarantinedMessages.release, customers.quarantinedMessages.deny, customers.quarantinedMessages.batchRelease, customers.quarantinedMessages.batchDeny

Jeder API-Aufruf zählt als eine Anfrage, unabhängig von der Seitengröße oder, bei Batchmethoden, der Anzahl der Nachrichten im Batch. Beispielsweise wird für eine batchRelease-Anfrage mit 500 Nachrichten eine Schreibanfrage verbraucht.

Sie können die aktuelle Kontingentnutzung Ihres Projekts in der Google Cloud Console unter APIs und Dienste > Aktivierte APIs und Dienste > Admin Quarantine API > Kontingente und Systemlimits einsehen.

Anfragebeschränkungen

Einschränkung Wert
Maximal pageSize für list- und search-Anfragen 300 Nachrichten
Maximale Anzahl von Nachrichten pro batchRelease- oder batchDeny-Anfrage 500 Nachrichten
Such- und Listenfenster In den letzten 30 Tagen empfangene Nachrichten

Kontingentfehler beheben

Wenn Ihr Projekt ein Kontingent überschreitet, gibt die API den HTTP-Fehler 429 mit dem Status RESOURCE_EXHAUSTED zurück:

{
  "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"
  }
}

So bleiben Sie innerhalb der Kontingente:

  • Wiederholungsversuche mit exponentiellem Backoff Wenn Sie den Fehler 429 erhalten, warten Sie, bevor Sie es noch einmal versuchen, und erhöhen Sie die Wartezeit nach jedem fehlgeschlagenen Versuch. Weitere Informationen finden Sie unter Exponentieller Backoff.
  • Verwenden Sie die größte nützliche Seitengröße. Such- und Listenanfragen haben das kleinste Kontingent. Fordern Sie bis zu 300 Nachrichten pro Seite an, anstatt viele kleine Seiten zu verwenden.
  • Filter verwenden: Grenzen Sie search-Anfragen mit einem filter oder query ein, damit Sie nur die benötigten Nachrichten abrufen.
  • Verwenden Sie Batch-Methoden für Bulk-Aktionen. Mit einer einzelnen batchRelease- oder batchDeny-Anfrage können bis zu 500 Nachrichten freigegeben oder abgelehnt werden. Bei einem release- oder deny-Aufruf ist es nur eine Nachricht.
  • Vorgänge nur sparsam abfragen. Wenn Sie auf einen Batchvorgang warten, rufen Sie die Methode get der Ressource customers.operations alle paar Sekunden auf, anstatt kontinuierlich.
  • Inkrementell synchronisieren. Anstatt bei jedem Durchlauf die gesamte Quarantäne neu aufzulisten, filtern Sie nach status = PENDING_TRIAGE und verarbeiten Sie nur neue Nachrichten.

Kontingenterhöhungen sind während der Entwicklervorschau nicht verfügbar. Wenn Ihr Anwendungsfall höhere Kontingente erfordert, können Sie Ihr Feedback über das Google Workspace Entwicklervorschauprogramm einreichen.