Um contêiner para a atividade de e-discovery relacionada a um caso ou investigação específica. Um caso inclui: consultas de pesquisa salvas, uma lista de contas com dados em retenção, exportações de dados e uma lista das contas que podem acessar o caso. Um caso é representado por um
recurso Matter.
Uma política que impede que os serviços do Google Workspace excluam dados. As guardas de documentos
geralmente são usadas para preservar dados para fins legais e de investigação.
As guardas de documentos substituem as regras de retenção.
Uma guarda de documentos é representada por um
recurso Hold.
Uma consulta salva em um caso. Você pode executar novamente uma consulta salva para receber dados
que mudaram desde a última vez que ela foi feita. Você também pode copiar consultas salvas e reutilizá-las em outros assuntos. Uma consulta salva é representada por um recurso de consulta salva.
Um conjunto de dados do Google Workspace para download que corresponde à sua consulta de pesquisa. Uma exportação é representada por um recurso de exportação.
Próximas etapas
Para trabalhar com recursos do Vault, a conta precisa ter os
privilégios necessários do Vault
e acesso ao caso. Para acessar um caso, a conta precisa ter criado
o caso, ter recebido o compartilhamento dele ou ter o privilégio Ver todos os
casos. Por exemplo, para fazer o download de uma exportação, uma conta precisa do privilégio Gerenciar exportações e do caso compartilhado com ela.
Para saber mais sobre o desenvolvimento com as APIs do Google Workspace, incluindo o processamento de autenticação e autorização, consulte Começar a desenvolver para o Workspace.
Para saber como configurar e executar um app simples do Vault, confira
um guia de início rápido em Python ou
Java.
[null,null,["Última atualização 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)."]]
