Limiti di utilizzo

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

Limiti di prodotto

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

Quote per le richieste API

Ogni organizzazione può effettuare 600 letture di pratiche al minuto, in tutti i progetti e gli utenti, incluse le richieste tramite l'API Vault e vault.google.com.

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

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

Utilizzo della quota per metodo

La quota utilizzata da una richiesta dipende dal metodo chiamato. La tabella seguente 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 pratica scritta
matters.count 1 conteggio
matters.get 1 pratica letta
matters.list 10 letture di pratiche
matters.addPermissions
matters.removePermissions 		1 pratica letta
1 pratica scritta
1 pratica con autorizzazioni di scrittura
matters.exports.create 1 esportazione letta
10 esportazioni scritte
matters.exports.delete 1 esportazione in scrittura
matters.exports.get 1 esportazione letta
matters.exports.list 5 esportazioni
matters.holds.addHeldAccounts
matters.holds.create
matters.holds.delete
matters.holds.removeHeldAccounts
matters.holds.update 		1 lettura della pratica
1 scrittura della pratica
1 lettura della sospensione
1 scrittura della sospensione
matters.holds.list 1 lettura della pratica
3 letture della presa
matters.holds.accounts.create
matters.holds.accounts.delete
matters.holds.accounts.list 		1 lettura della pratica
1 scrittura della pratica
1 lettura della sospensione
1 scrittura della sospensione
matters.savedQueries.create
matters.savedQueries.delete 		1 pratica letta
1 pratica scritta
1 query salvata letta
1 query salvata scritta
matters.savedQueries.get 1 pratica letta
1 query salvata letta
matters.savedQueries.list 1 lettura di una pratica
3 letture di query salvate
operations.get 1 lettura di un'operazione a lunga esecuzione

Risolvi 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 ogni X minuti), consigliamo che il codice rilevi l'eccezione e utilizzi un backoff esponenziale troncato per assicurarsi 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 riprova le richieste utilizzando tempi di attesa tra le richieste che aumentano in modo esponenziale, fino a un tempo di backoff massimo. Se le richieste non vanno ancora 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 ritenta le richieste in modo esponenziale, aumentando il tempo di attesa tra i tentativi 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 a inviare la richiesta.
  3. Se la richiesta non va a buon fine, attendi 2 + random_number_milliseconds e riprova a inviare la richiesta.
  4. Se la richiesta non va a buon fine, attendi 4 + random_number_milliseconds e riprova.
  5. E così via, fino a un tempo di maximum_backoff.
  6. 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), con n incrementato di 1 per ogni iterazione (richiesta).
  • random_number_milliseconds è un numero casuale di millisecondi inferiore o uguale a 1000. In questo modo si evitano casi in cui molti client vengono sincronizzati da una determinata situazione e tutti riprovano contemporaneamente, inviando richieste in onde sincronizzate. Il valore di random_number_milliseconds viene ricalcolato dopo ogni richiesta di riprova.
  • maximum_backoff dura in genere 32 o 64 secondi. Il valore appropriato dipende dal caso d'uso.

Il client può continuare a riprovare dopo aver raggiunto l'ora maximum_backoff. I nuovi tentativi dopo questo punto non devono continuare ad aumentare il tempo di backoff. Ad esempio, se un client utilizza un valore maximum_backoff di 64 secondi, dopo aver raggiunto questo valore, il client può riprovare ogni 64 secondi. A un certo punto, i client devono essere impediti di riprovare a tempo indeterminato.

Il tempo di attesa tra i tentativi e il numero di tentativi dipendono dal caso d'uso e dalle condizioni di rete.

Richiedi un aumento della quota

A seconda dell'utilizzo delle risorse del progetto, potresti voler richiedere un aggiustamento della quota. Le chiamate API di un service account sono considerate come se utilizzassero un singolo account. La richiesta di una quota modificata non ne garantisce l'approvazione. L'approvazione delle richieste di aggiustamento della quota che aumenterebbero in modo significativo il valore della quota può richiedere più tempo.

Non tutti i progetti hanno le stesse quote. Man mano che utilizzi sempre più Google Cloud nel tempo, i valori delle 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 Google Workspace.