Limiti e quote proteggono l'infrastruttura Google da un processo automatizzato che utilizza l'API Enterprise License Manager 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 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.
Se le tue richieste devono essere completate in un periodo di tempo fisso, inviale in gruppo. A seconda dello scopo dell'API e dell'aumento del numero di richieste, si verificheranno errori di quota.
Se non riesci a utilizzare la funzionalità consigliata per le richieste in batch API, utilizza l'algoritmo di backoff esponenziale. Per tutti gli errori basati sul tempo (massimo N elementi per X secondi per thread), in particolare gli errori del codice di stato 503, 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 Enterprise License Manager 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 di quote API | Quote |
|---|---|
| Query al secondo (QPS) | La quota QPS è 1. |
| Categorie limite API | Limiti |
|---|---|
| Stringa di query maxResults | La dimensione massima di maxResults è 100. |
| Altri tipi di limiti | Limitazioni e linee guida |
|---|---|
| Richieste batch |
L'API supporta l'invio di richieste batch. |
| Formato dei dati nelle risposte dell'API | Il formato dei dati della risposta è JavaScript Object Notation (JSON). |
| Abilitazione dell'API Enterprise License Manager | L'API Provisioning deve essere attivata prima di effettuare chiamate all'API Enterprise License Manager. Nel tuo pannello di controllo, vai alla pagina Impostazioni della scheda Utenti e gruppi e attiva l'API di provisioning. Salva le modifiche. Inoltre, il servizio Google Gruppi deve essere abilitato e attivato. |
| Richieste non autorizzate | L'API non accetta richieste non autorizzate. Una richiesta è considerata non autorizzata se non viene fornito alcun token di autorizzazione. Per ulteriori informazioni, vedi Autorizzazione delle richieste . |