Limiti di utilizzo

Poiché l'API Google Vault è un servizio condiviso, applichiamo quote e limitazioni per assicurarci che venga utilizzata in modo equo da tutti gli utenti e per proteggere l'integrità complessiva del sistema Google Workspace.

Limiti di prodotto

Non puoi eseguire più di 20 esportazioni in tutta l'organizzazione.

Quote per le richieste API

Ogni organizzazione possono eseguire 600 letture delle pratiche al minuto per tutti i progetti e gli utenti, incluse le richieste tramite l'API Vault e vault.google.com.

Le seguenti tabelle elencano i limiti delle richieste al minuto per progetto:

Richieste di lettura al minuto per progetto
Esportazione, pratica e query salvata 120
Metti in attesa 228
Operazione a lunga esecuzione 300
Richieste di scrittura al minuto per progetto
Esporta 20
Metti in attesa 60
Autorizzazioni Matter 30
Matter 60
Query salvata 45
Cerca (conteggio) richieste al minuto per progetto
Conteggi delle ricerche 20

Utilizzo della quota per metodo

La quota utilizzata da una richiesta dipende dal metodo chiamato. La seguente tabella elenca l'utilizzo della quota per metodo:

Metodo Costi della quota
matters.close
matters.create
matters.delete
matters.reopen
matters.update
matters.undelete 		1 pratica letta
1 scrittura pratiche
matters.count 1 conteggio
matters.get 1 pratica letta
matters.list 10 letture delle pratiche
matters.addPermissions
matters.removePermissions 		1 lettura Matter
1 scrittura Matter
1 autorizzazione di scrittura Matter
matters.exports.create 1 lettura esportazione
10 scritture esportazione
matters.exports.delete 1 esportazione in scrittura
matters.exports.get 1 esportazione letta
matters.exports.list 5 letture dell'esportazione
matters.holds.addHeldAccounts
matters.holds.create
matters.holds.delete
matters.holds.removeHeldAccounts
matters.holds.update 		1 lettura di pratiche
1 scrittura di pratiche
1 blocco di lettura
1 blocco di scrittura
matters.holds.list 1 pratica letta
3 letture di blocchi
matters.holds.accounts.create
matters.holds.accounts.delete
matters.holds.accounts.list 		1 lettura di pratiche
1 scrittura di pratiche
1 blocco di lettura
1 blocco di scrittura
matters.savedQueries.create
matters.savedQueries.delete 		1 scrittura Matter
1 scrittura Matter
1 query salvata letta
1 scrittura query salvata
matters.savedQueries.get 1 pratica letta
1 query salvata letta
matters.savedQueries.list 1 pratica letta
3 letture di query salvate
operations.get Lettura di 1 operazione a lunga esecuzione

Risolvere gli errori di quota basati sul tempo

Se superi una quota al minuto o per organizzazione, in genere ricevi una risposta con codice di stato HTTP 429: Too many requests.

Per tutti gli errori basati sul tempo (massimo N richieste per X minuti), ti consigliamo che il tuo codice rilevi l'eccezione e utilizzi un backoff esponenziale troncato per assicurarti che i dispositivi non generino un carico eccessivo.

Il backoff esponenziale è una strategia standard di gestione degli errori per le applicazioni di rete. Un algoritmo di backoff esponenziale tenta di nuovo le richieste utilizzando tempi di attesa esponenziali tra le richieste, 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 all'esito della richiesta.

Algoritmo di esempio

Un algoritmo di backoff esponenziale tenta di ripetere le richieste in modo esponenziale, aumentando il tempo di attesa tra un nuovo tentativo e l'altro fino a un tempo di backoff massimo. Ad esempio:

  1. Effettua una richiesta all'API Google Vault.
  2. Se la richiesta non va a buon fine, attendi 1 + random_number_milliseconds e riprova.
  3. Se la richiesta non va a buon fine, attendi 2 + random_number_milliseconds e riprova.
  4. Se la richiesta non va a buon fine, attendi 4 + random_number_milliseconds e riprova.
  5. E così via, fino a maximum_backoff volta.
  6. Continua ad attendere e a riprovare fino al numero massimo di nuovi tentativi, ma non aumentare il periodo di attesa tra un nuovo tentativo e l'altro.

dove:

  • Il tempo di attesa è min(((2^n)+random_number_milliseconds), maximum_backoff), con n incrementato di 1 per ogni iterazione (richiesta).
  • random_number_milliseconds è un numero casuale di millisecondi minore o uguale a 1000. Ciò consente di evitare i casi in cui molti client vengono sincronizzati in base a qualche situazione e tutti riprovano contemporaneamente, inviando le richieste in wave sincronizzate. Il valore di random_number_milliseconds viene ricalcolato dopo ogni richiesta di nuovo tentativo.
  • maximum_backoff dura in genere 32 o 64 secondi. Il valore appropriato dipende dal caso d'uso.

Il client può continuare a riprovare una volta raggiunto il limite di maximum_backoff. I nuovi tentativi dopo questo punto non devono necessariamente 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 dipende dal caso d'uso e dalle condizioni della rete.

Richiedi un aumento della quota

A seconda dell'utilizzo delle risorse del progetto, potresti voler richiedere un aumento della quota. Le chiamate API effettuate da un account di servizio utilizzano un singolo account. La richiesta di un aumento di quota non ne garantisce l'approvazione. L'approvazione di aumenti significativi di quota può richiedere più tempo.

Non tutti i progetti hanno le stesse quote. Con l'uso crescente di Google Cloud nel tempo, le tue quote potrebbero dover aumentare. 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:

Prezzi

L'uso dell'API Google Vault è disponibile senza costi aggiuntivi per i clienti di Google Workspace.