I limiti e le quote proteggono l'infrastruttura di Google da un processo automatizzato che utilizza l'API Email Audit in modo inappropriato. Le richieste eccessive da un'API potrebbero essere il risultato di un errore di battitura innocuo o di un sistema progettato in modo inefficiente che effettua chiamate API inutili. Indipendentemente dalla causa, bloccare il traffico da una fonte specifica quando raggiunge un determinato livello è necessario per la salute generale del sistema Google Workspace. I limiti contribuiscono a garantire che le azioni di uno sviluppatore non possano influire negativamente sulla community più ampia.
Nell'improbabile eventualità che la richiesta API non vada a buon fine, riceverai un codice di stato
HTTP. Un codice di stato 403 contiene informazioni di errore relative a input errati, mentre un codice di stato HTTP 503 contiene informazioni di errore che indicano quali quote API sono state superate. Queste risposte consentono alla tua applicazione personalizzata
di rilevare questi errori e intraprendere l'azione appropriata.
Se le tue richieste devono essere completate in un periodo di tempo fisso, inviale in parallelo o utilizza più thread nella tua applicazione Java o C#. Un esempio di richieste parallele è la richiesta di piccoli batch di email di utenti diversi anziché l'aggiunta o la rimozione simultanea di molte email di un solo utente. Nel caso dei thread, prova a iniziare con 10 thread, uno per ogni email utente. Tieni presente che il suggerimento relativo ai thread presenta dei compromessi e non è utile per tutte le situazioni API. Se il numero di richieste diventa troppo elevato, si verificano errori di quota. Un altro esempio di compromesso è la quota per l'API Email Audit per la velocità massima complessiva di caricamento dei messaggi. La velocità di caricamento è di una richiesta API al secondo per utente, indipendentemente dal numero di thread che effettuano richieste di caricamento.
Per tutti gli errori basati sul tempo (massimo N elementi per N secondi per thread), in particolare gli errori del codice di stato 503, ti consigliamo di fare in modo che il codice rilevi l'eccezione e, utilizzando un algoritmo di backoff esponenziale, attenda un breve ritardo prima di riprovare la chiamata non riuscita. Un esempio di API Email Audit per un thread consiste nell'attendere 5 secondi e riprovare a effettuare la chiamata non riuscita. Se la richiesta ha esito positivo, ripeti questo pattern per gli altri thread. Se la seconda richiesta non va a buon fine, l'applicazione deve
ridurre la frequenza della richiesta finché una chiamata non va a buon fine. Ad esempio, aumenta il ritardo iniziale di 5 secondi a 10 secondi e riprova a effettuare la chiamata non riuscita. Inoltre, decidi un limite di tentativi. Ad esempio, riprova a effettuare una richiesta da 5
a 7 volte con tempi di ritardo diversi prima che l'applicazione restituisca un errore
all'utente.
La tabella seguente elenca i limiti per l'API Email Audit:
| Categorie di limiti API | Limiti |
|---|---|
| File della casella di posta criptata, creazione |
La creazione di file di casella di posta criptati potrebbe richiedere fino a diversi giorni per la preparazione del sistema, a seconda delle dimensioni. |
| File della casella di posta criptati, errori di eliminazione |
Quando
elimini
una casella di posta criptata e si verificano errori, alla richiesta viene assegnato lo stato
|
La tabella seguente elenca le quote per l'API Email Audit:
| Categorie di quote API | Quote |
|---|---|
| Token di autenticazione ClientLogin |
Valido per 24 ore. L'errore è |
| Formati di data |
Converti tutte le date nel formato UTC (Coordinated Universal Time) prima di utilizzarle con l'API Email Audit. Per maggiori informazioni, consulta il convertitore UTC. |
|
File della casella postale criptati, riepiloghi |
Google conserva i file della casella di posta criptata per 3 settimane. Trascorso questo periodo, vengono eliminati. È responsabilità dell'amministratore del dominio scaricare questi file di casella postale entro questo periodo di tempo. |
| File della casella postale criptati, formato |
I file della casella criptata sono in formato mbox. |
| File della casella di posta criptati, richieste di creazione massime |
Il numero massimo di richieste di creazione di esportazione di caselle postali al giorno è pari a 100 richieste da tutti gli amministratori del dominio. |
| Stato del file della casella di posta criptata, paginazione |
Quando richiedi lo stato di tutte le richieste di casella postale, le risposte possono
restituire grandi quantità di dati. L'API Email Audit raggruppa
questi dati in pagine, ognuna delle quali contiene un massimo di 100
voci e un URI in un tag |
| Monitoraggio email |
Il numero massimo di richieste di monitoraggio email al giorno è 1500. Questo limite è per il dominio e include tutte le richieste effettuate da qualsiasi amministratore durante il giorno. |
| Chiave pubblica |
L'API Email Audit supporta una sola chiave. La chiave pubblica utilizza il software GNU Privacy Guard (GPG). È in formato PGP ed è una chiave di crittografia RSA codificata in ASCII. Prima di caricare la chiave pubblica, devi prima convertirla in una stringa con codifica Base64. Il file della chiave pubblica deve essere letto con il set di caratteri US-ASCII, (IANA nome del set di caratteri preferito per ASCII). |
| Ricerca |
I parametri |