Limiti di utilizzo e quote

I limiti e le quote proteggono l'infrastruttura di Google da un processo automatizzato che utilizza l'API Alert Center in modo inappropriato. Un numero eccessivo di richieste da un'API potrebbe 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 proveniente da una fonte specifica una volta raggiunto un determinato livello è necessario per la salute generale del sistema Google Workspace. In questo modo, le azioni di uno sviluppatore non possono influire negativamente sulla community più ampia.

Nell'improbabile eventualità che la richiesta API non vada a buon fine, riceverai una risposta con un codice di stato HTTP. Un codice di stato 403 contiene informazioni sull'errore relativo all'input errato, mentre un codice di stato HTTP 503 contiene informazioni sull'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 nell'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 dell'API. Se il numero di richieste diventa troppo elevato, si verificano errori di quota.

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 exponential backoff, attenda un breve ritardo prima di riprovare la chiamata non riuscita. Un esempio di API Alert Center per un thread consiste nell'attendere 5 secondi e riprovare 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 delle richieste 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 5-7 volte con tempi di ritardo diversi prima che l'applicazione restituisca un errore all'utente.

Categorie di limiti API Limiti
Tassi QPS e QPD del Centro avvisi L'API limita il numero di richieste per il progetto della console API. Il numero massimo di richieste al secondo (QPS del progetto) del progetto API è 1000. Inoltre, il numero massimo di richieste per utente al secondo (QPS utente) è 150.

Se questi limiti vengono superati, il server restituisce un codice di stato HTTP 503. Utilizza l'algoritmo di backoff esponenziale quando riprovi a inviare le richieste.

Altri tipi di limiti Limitazioni e linee guida
Formato dei dati, predefinito Il formato di dati predefinito è JSON.
Richieste non autorizzate Google non consente richieste non autorizzate a questa API. Una richiesta viene considerata non autorizzata se non viene fornito alcun token di autorizzazione. Per saperne di più, consulta Autorizzazione delle richieste.

Richiedi un aumento della quota per progetto

A seconda dell'utilizzo delle risorse del progetto, potresti voler richiedere un aggiustamento della quota. Le chiamate API di un service account sono considerate come se utilizzassero un singolo account. La richiesta di una quota modificata non ne garantisce l'approvazione. L'approvazione delle richieste di aggiustamento della quota che aumenterebbero in modo significativo il valore della quota può richiedere più tempo.

Non tutti i progetti hanno le stesse quote. Man mano che utilizzi sempre più Google Cloud nel tempo, i valori delle quote potrebbero dover aumentare. Se prevedi un aumento imminente e consistente dell'utilizzo, puoi richiedere un aggiustamento della quota in modo proattivo nella pagina Quote della console Google Cloud.

Per saperne di più, consulta le seguenti risorse: