Method: matters.holds.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Répertorie les obligations de conservation associées à un litige.
Requête HTTP
GET https://vault.googleapis.com/v1/matters/{matterId}/holds
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
matterId |
string
ID du litige.
|
Paramètres de requête
| Paramètres |
pageSize |
integer
Nombre de retenues à renvoyer dans la réponse, compris entre 0 et 100. Si vous laissez ce champ vide ou définissez sa valeur sur 0, cela revient à définir pageSize sur 100.
|
pageToken |
string
Jeton de pagination renvoyé dans la réponse. Un jeton vide signifie que vous devez commencer depuis le début.
|
view |
enum (HoldView)
Détail à renvoyer pour une retenue.
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Obligations de conservation pour un litige
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
| Représentation JSON |
{
"holds": [
{
object (Hold)
}
],
"nextPageToken": string
} |
| Champs |
holds[] |
object (Hold)
Liste des obligations de conservation.
|
nextPageToken |
string
Jeton de page permettant de récupérer la page suivante des résultats dans la liste. Si ce champ est vide, cela signifie qu'il n'y a plus de réservations à afficher.
|
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/ediscovery.readonlyhttps://www.googleapis.com/auth/ediscovery
Pour en savoir plus, consultez le guide d'autorisation.
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/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[],[],null,["# Method: matters.holds.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListHoldsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists the holds in a matter.\n\n### HTTP request\n\n`GET https://vault.googleapis.com/v1/matters/{matterId}/holds`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|-------------------------|\n| `matterId` | `string` The matter ID. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The number of holds to return in the response, between 0 and 100 inclusive. Leaving this empty, or as 0, is the same as **pageSize** = 100. |\n| `pageToken` | `string` The pagination token as returned in the response. An empty token means start from the beginning. |\n| `view` | `enum (`[HoldView](/workspace/vault/reference/rest/v1/HoldView)`)` The amount of detail to return for a hold. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe holds for a matter.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------|\n| ``` { \"holds\": [ { object (/workspace/vault/reference/rest/v1/matters.holds#Hold) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------|\n| `holds[]` | `object (`[Hold](/workspace/vault/reference/rest/v1/matters.holds#Hold)`)` The list of holds. |\n| `nextPageToken` | `string` Page token to retrieve the next page of results in the list. If this is empty, then there are no more holds to list. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/ediscovery.readonly`\n- `https://www.googleapis.com/auth/ediscovery`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
