Limiti di utilizzo
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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 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 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 riprovabili (ad esempio l'errore
RESOURCE_EXHAUSTED restituito quando una richiesta supera i limiti) riprovando la richiesta, preferibilmente utilizzando il backoff esponenziale.
- Se esegui il polling per rilevare le modifiche su un endpoint in cui questa funzionalità è disponibile, valuta la possibilità di utilizzare le notifiche push.
- Se hai ancora bisogno di effettuare più richieste rispetto ai limiti assegnati al tuo
progetto, consulta di seguito le istruzioni 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.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-01 UTC.
[null,null,["Ultimo aggiornamento 2025-08-01 UTC."],[],[],null,["# Usage Limits\n\nQuota is checked on a **60-second moving average** , which **allows for spikes in\nusage**. By default, the Classroom API is subject to the limits in the following\ntable:\n\n| Limit | Quota Standard |\n|-------------------------------|-------------------------|\n| Queries per day per client | 4,000,000 (Avg. 46 QPS) |\n| Queries per minute per client | 3,000 (50 QPS) |\n| Queries per minute per user | 1,200 (20 QPS) |\n\nThe permitted QPS may be increased or decreased depending on a number of\noperational factors.\n\nIf you need to make more requests than the limits applied to your project:\n\n1. First, ensure that you respond to retryable errors (such as the `RESOURCE_EXHAUSTED` error that is returned when a request exceeds your limits) by retrying the request, preferably using exponential backoff.\n2. If you are polling for changes on an endpoint where this is offered, consider using [push notifications](/workspace/classroom/guides/push-notifications) instead.\n3. If you still need to make more requests than the limits assigned to your project, see below for instructions on requesting higher limits.\n\nTo view or change usage limits for your project, or to request an increase to\nyour quota, do the following:\n\n1. If you don't already have a [billing account](//cloud.google.com/billing/docs/how-to/manage-billing-account) for your project, then create one.\n2. [Visit the Enabled APIs page of the\n API library](https://console.cloud.google.com/apis/enabled) in the API Console, and select an API from the list.\n3. To view and change quota-related settings, select **Quotas** . To view usage statistics, select **Usage**."]]
