Limiti di utilizzo e quote

Limiti e quote proteggono l'infrastruttura Google da un processo automatizzato che utilizza l'API Data Transfer in modo inappropriato. Le richieste eccessive di un'API potrebbero derivare da un errore ortografico innocuo o da un sistema progettato in modo inefficiente che effettua chiamate API inutili. Indipendentemente dalla causa, per l'integrità complessiva del sistema Google Workspace è necessario bloccare il traffico proveniente da una sorgente specifica quando raggiunge un determinato livello. Garantisce che le azioni di uno sviluppatore non possano influire negativamente sulla community più ampia.

Errori di richiesta API

Nell'improbabile caso che la tua richiesta API non vada a buon fine, l'applicazione riceve una risposta con codice di stato HTTP. Un codice di stato 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.

Completare le richieste in un periodo di tempo fisso

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, puoi interrompere le richieste in base al mese o a un altro periodo di tempo. Nel 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 relativi al codice di stato 503, consigliamo che il codice rilevi l'eccezione e, utilizzando un algoritmo di backoff esponenziale, attendi un leggero ritardo prima di riprovare a eseguire la chiamata non riuscita. Un esempio dell'API Data Transfer per un thread prevede l'attesa di 5 secondi e la ripetizione della 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é la chiamata non ha esito positivo. Ad esempio, aumenta il ritardo iniziale di 5 secondi a 10 secondi e riprova a eseguire la chiamata non riuscita. Inoltre, decidi 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 tipi di limiti Limitazioni e linee guida
Formati dei tipi di contenuti Un messaggio email deve essere nel formato di testo RFC 822 standard. Il formato di tipo di contenuti di una richiesta per il caricamento delle email migrate utilizza 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 Data Transfer non supporta i criteri sulla posizione dei dati che richiedono l'archiviazione dei dati in confini geografici o politici specifici per motivi contrattuali. Non utilizzare l'API Data Transfer se per il tuo account è richiesta la posizione dei dati.
Inserzioni di messaggi paralleli L'API Data Transfer supporta le richieste parallele per l'inserimento di email in diversi archivi di gruppo. Tuttavia, l'API Data Transfer non supporta l'inserimento di messaggi in parallelo nello stesso archivio di gruppi. Le richieste batch non sono supportate in questa versione dell'API.
Richieste non autorizzate L'API Data Transfer non accetta richieste non autorizzate. Una richiesta è considerata non autorizzata se non viene fornito alcun token di autorizzazione.