API Groups Migration: limiti e quote

Limiti e quote proteggono l'infrastruttura Google da un processo automatizzato che utilizza l'API Groups Migration in modo inappropriato. Le richieste eccessive di un'API potrebbero derivare da un errore di battitura innocuo o da un sistema progettato in modo inefficiente che effettua chiamate API inutili. Indipendentemente dalla causa, è necessario bloccare il traffico proveniente da una sorgente specifica una volta raggiunto un determinato livello per l'integrità complessiva del sistema Google Workspace.

Errori di richiesta API

Nell'improbabile caso che la richiesta API non vada a buon fine, l'applicazione riceve una risposta con codice di stato HTTP. Un codice di stato HTTP 403 contiene informazioni sull'errore relative a un input non corretto, mentre un codice di stato HTTP 503 contiene informazioni sull'errore che indicano quali quote API sono state superate. Queste risposte consentono all'applicazione personalizzata di rilevare questi errori e di intraprendere le azioni appropriate.

Richieste urgenti

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#. Ad esempio, interrompi le richieste in base al mese o a un altro periodo di tempo. In caso di thread, prova a iniziare con 10 thread, un thread per richiesta. Il suggerimento sui thread presenta dei compromessi e non è utile per tutte le situazioni relative all'API. Se il numero di richieste diventa troppo elevato, si verificano errori di quota.

Errori basati sul tempo

Per tutti gli errori basati sul tempo (massimo N elementi per X secondi per thread), in particolare gli errori del codice di stato 503, ti consigliamo di individuare il codice per rilevare l'eccezione e, utilizzando un algoritmo di backoff esponenziale, attendere un piccolo ritardo prima di riprovare a eseguire la chiamata non riuscita. Un esempio dell'API Groups Migration per un thread è attendere 5 secondi e riprovare la chiamata non riuscita. Se la richiesta ha esito positivo, ripeti lo schema per gli altri thread. Se la seconda richiesta non va a buon fine, l'applicazione deve fare lo scale back in base alla frequenza della richiesta fino a quando la chiamata non va a buon fine. Ad esempio, aumenta il ritardo iniziale di 5 secondi a 10 secondi e riprova a eseguire la chiamata non riuscita. Stabilisci anche un limite per i tentativi. Ad esempio, riprova una richiesta da 5 a 7 volte con tempi di ritardo diversi prima che l'applicazione restituisca un errore all'utente.

Limiti

Categorie di limiti delle API Limiti
Query al secondo (QPS) Il limite per il progetto sviluppatore è di 10 query al secondo (QPS) per account.

Quote

Categorie di quote API Quote
Numero massimo di richieste API al giorno Il numero massimo di richieste API al giorno è 500.000.
Archiviazione, scadenza dei messaggi Gli archivi del gruppo non hanno scadenza. I messaggi rimangono nell'archivio finché il gruppo non viene eliminato. Il criterio di conservazione delle email non influisce sui messaggi presenti nell'archivio di un gruppo.
Dimensioni messaggio di posta La dimensione massima di un messaggio email è 25 MB. Questo limite include intestazioni dei metadati, corpo ed eventuali allegati del messaggio.

Altri tipi di limiti

Altri limiti Limitazioni e linee guida
Formati dei tipi di contenuti Un messaggio email deve essere nel formato di testo RFC 822 standard. Durante il caricamento delle email migrate, il tipo di contenuti di una richiesta deve utilizzare l'intestazione Content-type: message/rfc822.
Formato dei dati nelle risposte dell'API Il formato dei dati della risposta è JavaScript Object Notation (JSON).
Norme sulla posizione dei dati L'API Groups Migration non supporta i criteri di località dei dati che richiedono l'archiviazione dei dati in confini geografici o politici specifici per motivi contrattuali. Non utilizzare l'API Groups Migration se la posizione dei dati è obbligatoria per il tuo account.
Inserzioni di messaggi paralleli L'API Groups Migration supporta le richieste parallele per l'inserimento di email in diversi archivi di gruppo. Tuttavia, l'API Groups Migration non supporta l'inserimento di messaggi in parallelo nello stesso archivio di gruppi. Inoltre, le richieste batch non sono supportate in questa versione dell'API Groups Migration.
Richieste non autorizzate L'API Groups Migration non accetta richieste non autorizzate. Una richiesta viene considerata non autorizzata se non viene fornito alcun token di autorizzazione. Per maggiori informazioni, consulta Informazioni su autenticazione e autorizzazione.