Un contenitore per l'attività di eDiscovery relativa a una controversia o a un'indagine specifica. Una pratica include: query di ricerca salvate, un elenco di account
con dati in attesa, esportazioni di dati e un elenco degli account che possono accedere
alla pratica. Una pratica è rappresentata da una
risorsa Pratica.
Un criterio che impedisce ai servizi Google Workspace di eliminare i dati. I blocchi
vengono di solito utilizzati per conservare dati a fini legali o di indagine.
I blocchi hanno la precedenza sulle
regole di conservazione.
Un blocco è rappresentato da una
risorsa Hold.
Una query che salvi in una pratica. Puoi eseguire di nuovo una query salvata per ottenere i dati
che sono cambiati dall'ultima esecuzione della query. Puoi anche copiare le query salvate e riutilizzarle in altre pratiche. Una query salvata è rappresentata da una
risorsa query salvata.
Un insieme scaricabile di dati di Google Workspace che corrispondono alla tua query di ricerca. Un'esportazione è rappresentata da una risorsa di esportazione.
Passaggi successivi
Per utilizzare le risorse di Vault, l'account deve disporre dei
privilegi di Vault richiesti
e dell'accesso alla pratica. Per accedere a una pratica, l'account deve averla creata, deve averla ricevuta in condivisione o deve disporre del privilegio Visualizzazione di tutte le pratiche. Ad esempio, per scaricare un'esportazione, un account deve disporre
del privilegio Gestione delle esportazioni e della pratica condivisa.
Per informazioni sullo sviluppo con le API Google Workspace, inclusa la gestione
dell'autenticazione e dell'autorizzazione, consulta
Inizia a sviluppare per Workspace.
Per scoprire come configurare ed eseguire una semplice app Vault, prova
una guida rapida in Python o
Java.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[],[],null,["# Vault API Overview\n\nWith the Vault API, you can manage eDiscovery projects, including the following tasks:\n\n- Create matters and set who has access to them\n- Place data on hold\n- Create and edit saved search queries\n- Start and monitor exports\n\n| **Note:** To set retention rules or audit Vault activity, use the Vault app. For details, see [the Vault Help Center](https://support.google.com/vault#topic=2739742).\n\nThe following is a list of common terms used in the Vault API:\n\n*[Matter](/workspace/vault/reference/rest/v1/matters)*\n: A container for eDiscovery activity related to a specific case or\n investigation. A matter includes: saved search queries, a list of accounts\n with data on hold, data exports, and a list of the accounts that can access\n the matter. A matter is represented by a\n [Matter resource](/workspace/vault/reference/rest/v1/matters#resource:-matter).\n\n*[Hold](/workspace/vault/reference/rest/v1/matters.holds)*\n: A policy that prevents Google Workspace services from deleting data. Holds\n are typically used to preserve data for legal or investigation purposes.\n Holds override\n [retention rules](https://support.google.com/vault/answer/2990828).\n A hold is represented by a\n [Hold resource](/workspace/vault/reference/rest/v1/matters.holds#resource:-hold).\n\n*[Saved search query](/workspace/vault/reference/rest/v1/matters.savedQueries)*\n: A query that you save in a matter. You can re-run a saved query to get data\n that changed since the last the query was run. You can also copy saved\n queries and reuse them in other matters. A saved query is represented by a\n [Saved query resource](/workspace/vault/reference/rest/v1/matters.savedQueries#resource:-savedquery).\n\n*[Export](/workspace/vault/reference/rest/v1/matters.exports)*\n: A downloadable set of Google Workspace data that match your search query. An\n export is represented by an [Export resource](/workspace/vault/reference/rest/v1/matters.exports).\n\nNext steps\n----------\n\n- To work with Vault resources, the account must have the\n [required Vault privileges](https://support.google.com/vault/answer/2799699)\n and access to the matter. To access a matter, the account must have created\n the matter, have the matter shared with them, or have the **View All\n Matters** privilege. For example, to download an export, an account needs\n the **Manage Exports** privilege and the matter shared with them.\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, see\n [Get started as a Workspace developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Vault app, try\n a quickstart in [Python](/workspace/vault/quickstart/python) or\n [Java](/workspace/vault/quickstart/java)."]]
