La quota viene controllata su una media mobile di 60 secondi, che consente picchi di utilizzo. Per impostazione predefinita, l'API Classroom è soggetta ai limiti riportati nella seguente tabella:
| Limite | Standard quota |
|---|---|
| Query al giorno per cliente | 4.000.000 (media 46 QPS) |
| Query al minuto per client | 3000 (50 QPS) |
| Query al minuto per utente | 1200 (20 QPS) |
Il QPS consentito può essere aumentato o diminuito in base a una serie di fattori operativi.
Se devi effettuare più richieste rispetto ai limiti applicati al tuo progetto:
- Innanzitutto, assicurati di rispondere agli errori non irreversibili (come l'errore
RESOURCE_EXHAUSTEDche viene restituito quando una richiesta supera i tuoi limiti) ritentando la richiesta, preferibilmente utilizzando il backoff esponenziale. - Se stai eseguendo il polling delle modifiche su un endpoint in cui questa funzionalità viene offerta, valuta la possibilità di utilizzare invece le notifiche push.
- Se devi comunque effettuare più richieste rispetto ai limiti assegnati al tuo progetto, vedi di seguito le istruzioni su come richiedere limiti più elevati.
Per visualizzare o modificare i limiti di utilizzo relativi al progetto o per richiedere un incremento della quota, procedi come segue:
- Se non hai ancora un account di fatturazione per il progetto, creane uno.
- Visita la pagina API abilitate della libreria API nella console API e seleziona un'API dall'elenco.
- Per visualizzare e modificare le impostazioni relative alla quota, seleziona Quote. Per visualizzare le statistiche sull'utilizzo, seleziona Utilizzo.