Poiché l'API Google Drive è un servizio condiviso, applichiamo quote e limitazioni per assicurarci che venga utilizzata in modo equo da tutti gli utenti e per proteggere le prestazioni complessive del sistema Google Workspace.
Le notifiche inviate all'indirizzo specificato quando si apre un canale di notifica non vengono conteggiate ai fini dei limiti di quota. Tuttavia, le chiamate ai metodi changes.watch
, channels.stop
e files.watch
vengono conteggiate nella tua quota.
Se superi una quota, riceverai una risposta del codice di stato HTTP 403: User rate limit
exceeded
. Anche ulteriori controlli della limitazione di frequenza sul backend di Drive potrebbero generare una risposta 429: Too many
requests
. In questo caso, utilizza un algoritmo di backoff esponenziale e riprova più tardi. A condizione di rispettare le quote riportate di seguito per minuto, non esiste un limite al numero di richieste che puoi effettuare al giorno.
La seguente tabella descrive in dettaglio i limiti per le query:
Quote | |||||
---|---|---|---|---|---|
Query |
|
Risolvere gli errori relativi alle quote basate sul tempo
Per tutti gli errori basati sul tempo (massimo N richieste ogni X minuti), consigliamo di far sì che il codice catturi l'eccezione e utilizzi un backoff esponenziale troncato per assicurarti che i dispositivi non generino un carico eccessivo.
Il backoff esponenziale è una strategia di gestione degli errori standard per le applicazioni di rete. Un algoritmo di backoff esponenziale riprova le richieste utilizzando tempi di attesa in aumento esponenziale tra una richiesta e l'altra, fino a un tempo di backoff massimo. Se le richieste continuano a non andare a buon fine, è importante che i ritardi tra le richieste aumentino nel tempo fino a quando la richiesta non va a buon fine.
Algoritmo di esempio
Un algoritmo di backoff esponenziale riprova le richieste in modo esponenziale, aumentando il tempo di attesa tra i tentativi fino a un tempo di backoff massimo. Ad esempio:
- Invia una richiesta all'API Google Drive.
- Se la richiesta non va a buon fine, attendi 1 +
random_number_milliseconds
e riprova. - Se la richiesta non va a buon fine, attendi 2 +
random_number_milliseconds
e riprova. - Se la richiesta non va a buon fine, attendi 4 +
random_number_milliseconds
e riprova. - E così via fino a un intervallo di
maximum_backoff
. - Continua ad attendere e riprovare fino al numero massimo di nuovi tentativi, ma non aumentare il periodo di attesa tra un tentativo e l'altro.
dove:
- Il tempo di attesa è
min(((2^n)+random_number_milliseconds), maximum_backoff)
, conn
incrementato di 1 per ogni iterazione (richiesta). random_number_milliseconds
è un numero casuale di millisecondi minore o uguale a 1000. In questo modo si evitano i casi in cui molti client vengono sincronizzati da qualche situazione e tutti riprovano contemporaneamente, inviando richieste in ondate sincronizzate. Il valore dirandom_number_milliseconds
viene ricalcolato dopo ogni richiesta di nuovo tentativo.maximum_backoff
in genere dura 32 o 64 secondi. Il valore appropriato dipende dal caso d'uso.
Il client può continuare a riprovare dopo aver raggiunto il tempo maximum_backoff
.
I tentativi successivi a questo punto non devono continuare ad aumentare il tempo di backoff. Ad esempio, se un client utilizza un tempo maximum_backoff
di 64 secondi, dopo aver raggiunto questo valore, può riprovare ogni 64 secondi. A un certo punto, ai client dovrebbe essere impedito di riprovare a tempo indeterminato.
Il tempo di attesa tra i nuovi tentativi e il numero di nuovi tentativi dipendono dal caso d'uso e dalle condizioni di rete.
Prezzi
L'uso dell'API Google Drive è disponibile senza costi aggiuntivi. Il superamento dei limiti di richieste di quota non comporta alcun addebito aggiuntivo e nessun addebito sull'account.
Richiedi un aumento della quota
A seconda dell'utilizzo delle risorse del progetto, potresti voler richiedere un aumento della quota. Le chiamate API da parte di un account di servizio sono considerate come se utilizzassero un singolo account. La richiesta di aumentare una quota non ne garantisce l'approvazione. L'approvazione può richiedere più tempo nel caso di un aumento consistente della quota.
Non tutti i progetti hanno le stesse quote. Man mano che utilizzi sempre più Google Cloud nel tempo, potrebbe essere necessario aumentare le quote. Se prevedi un aumento imminente e consistente dell'utilizzo, puoi richiedere un adeguamento della quota in modo proattivo nella pagina Quote della console Google Cloud.
Per saperne di più, consulta le seguenti risorse:
- Informazioni sulle richieste di aumento della quota
- Visualizzare l'utilizzo e i limiti delle quote attuali
- Richiedere un limite di quota più alto