Limiti e quote proteggono l'infrastruttura Google da un processo automatizzato che utilizza l'API Alert Center in modo inappropriato. Un numero eccessivo di richieste da parte di un'API potrebbe derivare da un errore di battitura innocuo o da un sistema progettato in modo non efficiente che effettua chiamate API inutili. Indipendentemente dalla causa, bloccare il traffico proveniente da una sorgente specifica una volta raggiunto un determinato livello è necessario per l'integrità complessiva del sistema Google Workspace. Garantisce che le azioni di uno sviluppatore non possano influire negativamente sulla community più ampia.
Nell'improbabile eventualità che la tua richiesta API non vada a buon fine, riceverai una risposta con codice di stato HTTP. Un codice di stato 403 contiene informazioni di errore relative a un input errato, 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.
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 di tante email da un singolo utente contemporaneamente. Nel caso dei thread, prova a iniziare con 10 thread, uno per ogni email dell'utente. Tieni presente che il suggerimento per i thread presenta dei compromessi e non è utile in tutte le situazioni relative all'API. Se il numero di richieste diventa troppo elevato, si verificheranno 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 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 di API Alert Center per un thread è attendere 5 secondi e riprovare a effettuare 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 dovrebbe ridurne la frequenza 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 a inviare una richiesta da 5 a 7 volte con tempi di ritardo diversi prima che l'applicazione restituisca un errore all'utente.
| Categorie limite API | Limiti |
|---|---|
| Percentuali di QPS e QPD del Centro avvisi | L'API limita il numero di richieste per il tuo progetto della console API. Il numero massimo di richieste al secondo del progetto API (QPS del progetto) è 1000. Inoltre, il numero massimo di richieste per utente al secondo (QPS dell'utente) è 150.
Se questi limiti vengono superati, il server restituisce un codice di stato HTTP |
| Altri tipi di limiti | Limitazioni e linee guida |
|---|---|
| Formato dei dati (predefinito) | Il formato dei dati predefinito è JSON. |
| Richieste non autorizzate | Google non consente richieste non autorizzate a questa API. Una richiesta è considerata non autorizzata se non viene fornito alcun token di autorizzazione. Per ulteriori informazioni, vedi Autorizzazione delle richieste. |
Richiedi un aumento della quota per progetto
A seconda dell'utilizzo delle risorse del progetto, potresti voler richiedere un aumento della quota. Per le chiamate API effettuate da un account di servizio viene utilizzato un singolo account. La richiesta di un aumento della quota non ne garantisce l'approvazione. L'approvazione di aumenti di quota significativi può richiedere più tempo.
Non tutti i progetti hanno le stesse quote. Con l'uso crescente di Google Cloud nel tempo, le tue quote potrebbero dover aumentare. Se prevedi un aumento imminente e significativo dell'utilizzo, puoi richiedere un adeguamento della quota proattivamente dalla pagina Quote nella console Google Cloud.
Per saperne di più, consulta le seguenti risorse:
- Informazioni sulle richieste di aumento della quota
- Visualizzare l'utilizzo e i limiti della quota attuale
- Richiedere un limite di quota più elevato