La quota viene controllata in base a una media mobile di 60 secondi, che consente picchi di utilizzo. Per impostazione predefinita, l'API Classroom è soggetta ai limiti riportati nella tabella seguente:
| Limite | Quota standard |
|---|---|
| Query al giorno per client | 4.000.000 (in media 46 QPS) |
| Query al minuto per client | 3000 (50 QPS) |
| Query al minuto per utente | 1200 (20 QPS) |
Il valore QPS consentito può aumentare o diminuire a seconda di una serie di fattori operativi.
Se devi effettuare più richieste rispetto ai limiti applicati al tuo progetto:
- Innanzitutto, assicurati di rispondere agli errori ripetibili (ad esempio l'errore
RESOURCE_EXHAUSTEDrestituito quando una richiesta supera i limiti) riprovando a inviare la richiesta, preferibilmente utilizzando il backoff esponenziale. - Se stai eseguendo il polling per verificare la presenza di modifiche su un endpoint in cui questa opzione è disponibile, valuta la possibilità di utilizzare le notifiche push invece.
- Se devi comunque effettuare più richieste rispetto ai limiti assegnati al tuo progetto, consulta le istruzioni riportate di seguito per 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 di 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.