Quote di utilizzo dell'API Mail Admin Quarantine

L'API Mail Admin Quarantine applica quote di utilizzo al minuto per ogni progetto Google Cloud per proteggere l'infrastruttura Google Workspace che cerca e recupera i messaggi in quarantena. Le quote sono raggruppate in base al tipo di lavoro eseguito da un metodo.

Quote

La tabella seguente elenca le quote. Ogni quota è per minuto per progetto Cloud e conteggia tutte le richieste effettuate dal progetto per tutti i clienti Google Workspace e gli amministratori di cui è stata eseguita la simulazione.

Quota Valore Metodi
Richieste di ricerca ed elenco 60 richieste al minuto customers.quarantinedMessages.list, customers.quarantinedMessages.search
Richieste di lettura 1200 richieste al minuto customers.quarantinedMessages.get, customers.quarantines.get, customers.quarantines.list, customers.operations.get
Richieste di scrittura 300 richieste al minuto customers.quarantinedMessages.release, customers.quarantinedMessages.deny, customers.quarantinedMessages.batchRelease, customers.quarantinedMessages.batchDeny

Ogni chiamata API viene conteggiata come una richiesta, indipendentemente dalle dimensioni della pagina o, per i metodi batch, dal numero di messaggi nel batch. Ad esempio, una richiesta batchRelease con 500 messaggi consuma una richiesta di scrittura.

Puoi visualizzare l'utilizzo attuale della quota del tuo progetto nella console Google Cloud in API e servizi > API e servizi abilitati > API Admin Quarantine > Quote e limiti di sistema.

Vincoli di richiesta

Vincolo Valore
Massimo pageSize per le richieste list e search 300 messaggi
Numero massimo di messaggi per richiesta batchRelease o batchDeny 500 messaggi
Finestra di ricerca ed elenco Messaggi ricevuti negli ultimi 30 giorni

Risolvi gli errori di quota

Quando il tuo progetto supera una quota, l'API restituisce un errore HTTP 429 con lo stato RESOURCE_EXHAUSTED:

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

Per rispettare le quote:

  • Riprova con un backoff esponenziale. Quando ricevi un errore 429, attendi prima di riprovare e aumenta il tempo di attesa dopo ogni tentativo non riuscito. Per maggiori dettagli, consulta Backoff esponenziale.
  • Utilizza la dimensione di pagina utile più grande. Le richieste di ricerca e di elenco hanno la quota più bassa. Richiedi fino a 300 messaggi per pagina anziché molte pagine di piccole dimensioni.
  • Utilizza i filtri. Restringi le richieste search con un filter o un query in modo da recuperare solo i messaggi di cui hai bisogno.
  • Utilizza i metodi batch per le azioni collettive. Una singola richiesta batchRelease o batchDeny può rilasciare o rifiutare fino a 500 messaggi, rispetto a un messaggio per chiamata release o deny.
  • Esegui il polling delle operazioni con parsimonia. Quando attendi un'operazione batch, chiama il metodo get della risorsa customers.operations ogni pochi secondi anziché continuamente.
  • Sincronizza in modo incrementale. Anziché elencare nuovamente l'intera quarantena a ogni esecuzione, filtra in base a status = PENDING_TRIAGE ed elabora solo i nuovi messaggi.

Gli aumenti di quota non sono disponibili durante l'Anteprima per gli sviluppatori. Se il tuo caso d'uso richiede quote più elevate, condividi il tuo feedback tramite il programma Anteprima per gli sviluppatori di Google Workspace.