Conteneur pour l'activité d'eDiscovery liée à une affaire ou une enquête spécifique. Un litige inclut les requêtes de recherche enregistrées, une liste des comptes dont les données sont en attente, les exportations de données et une liste des comptes pouvant accéder au litige. Une affaire est représentée par une ressource Matter.
Règle qui empêche les services Google Workspace de supprimer des données. Les obligations de conservation sont généralement utilisées pour conserver des données à des fins juridiques ou dans le cadre d'une enquête.
Les obligations de conservation prévalent sur les règles de conservation.
Une procédure de préservation à titre conservatoire est représentée par une ressource Hold.
Requête que vous enregistrez dans un litige. Vous pouvez réexécuter une requête enregistrée pour obtenir les données qui ont changé depuis la dernière exécution de la requête. Vous pouvez également copier des requêtes enregistrées et les réutiliser dans d'autres affaires. Une requête enregistrée est représentée par une ressource de requête enregistrée.
Ensemble téléchargeable de données Google Workspace correspondant à votre requête de recherche. Une exportation est représentée par une ressource d'exportation.
Étapes suivantes
Pour travailler avec les ressources Vault, le compte doit disposer des droits Vault requis et avoir accès à l'affaire. Pour accéder à un litige, le compte doit l'avoir créé, l'avoir partagé avec lui ou disposer du droit Afficher tous les litiges. Par exemple, pour télécharger une exportation, un compte doit disposer du droit Gérer les exportations et avoir accès au litige partagé.
Pour en savoir plus sur le développement avec les API Google Workspace, y compris sur la gestion de l'authentification et de l'autorisation, consultez Premiers pas en tant que développeur Workspace.
Pour apprendre à configurer et à exécuter une application Vault simple, essayez un guide de démarrage rapide en Python ou en Java.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
