Es un contenedor para la actividad de detección electrónica relacionada con un caso o una investigación específicos. Un asunto incluye consultas de búsqueda guardadas, una lista de cuentas con datos en conservación, exportaciones de datos y una lista de las cuentas que pueden acceder al asunto. Un asunto se representa con un recurso Matter.
Política que impide que los servicios de Google Workspace borren datos. Por lo general, las conservaciones se usan para preservar los datos con fines legales o de investigación.
Las conservaciones anulan las reglas de retención.
Una retención se representa con un recurso de retención.
Una búsqueda que guardas en un asunto. Puedes volver a ejecutar una consulta guardada para obtener los datos que cambiaron desde la última vez que se ejecutó la consulta. También puedes copiar las búsquedas guardadas y reutilizarlas en otros asuntos. Una consulta guardada se representa con un recurso de consulta guardada.
Un conjunto descargable de datos de Google Workspace que coinciden con tu búsqueda Una exportación se representa con un recurso de Exportación.
Próximos pasos
Para trabajar con los recursos de Vault, la cuenta debe tener los privilegios de Vault necesarios y acceso al asunto. Para acceder a un asunto, la cuenta debe haberlo creado, debe tenerlo compartido o debe tener el privilegio Ver todos los asuntos. Por ejemplo, para descargar una exportación, una cuenta necesita el privilegio Administrar exportaciones y el asunto compartido con ella.
Para obtener información sobre el desarrollo con las APIs de Google Workspace, incluido el manejo de la autenticación y la autorización, consulta Comienza a desarrollar con Workspace.
Para aprender a configurar y ejecutar una app de Vault simple, prueba una guía de inicio rápido en Python o Java.
[null,null,["Última actualización: 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)."]]
