Limiti di utilizzo

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 Standard di quota
Query al giorno per cliente 4.000.000 (46 QPS in media)
Query al minuto per client 3000 (50 QPS)
Query al minuto per utente 1200 (20 QPS)

Il QPS consentito può essere aumentato o diminuito a seconda di una serie di fattori operativi.

Se devi effettuare più richieste rispetto ai limiti applicati al tuo progetto:

  1. Innanzitutto, assicurati di rispondere agli errori ripetibili (ad esempio l'errore RESOURCE_EXHAUSTED restituito quando una richiesta supera i limiti) riprovando a inviare la richiesta, preferibilmente utilizzando il backoff esponenziale.
  2. Se esegui il polling per rilevare le modifiche su un endpoint in cui è offerta questa funzionalità, ti consigliamo di utilizzare le notifiche push.
  3. 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:

  1. Se non hai ancora un account di fatturazione per il progetto, creane uno.
  2. Visita la pagina API abilitate della libreria di API nella console API e seleziona un'API dall'elenco.
  3. Per visualizzare e modificare le impostazioni relative alla quota, seleziona Quote. Per visualizzare le statistiche sull'utilizzo, seleziona Utilizzo.