Method: matters.holds.list
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Muestra una lista de las retenciones de un asunto.
Solicitud HTTP
GET https://vault.googleapis.com/v1/matters/{matterId}/holds
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
matterId |
string
El ID del asunto
|
Parámetros de consulta
| Parámetros |
pageSize |
integer
Es la cantidad de retenciones que se mostrarán en la respuesta, entre 0 y 100 inclusive. Si lo dejas vacío o como 0, es lo mismo que pageSize = 100.
|
pageToken |
string
Es el token de paginación que se muestra en la respuesta. Un token vacío significa que debes comenzar desde el principio.
|
view |
enum (HoldView)
Es la cantidad de detalles que se mostrarán para una retención.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Las retenciones de un asunto
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
| Representación JSON |
{
"holds": [
{
object (Hold)
}
],
"nextPageToken": string
} |
| Campos |
holds[] |
object (Hold)
La lista de retenciones.
|
nextPageToken |
string
Es un token de página para recuperar la siguiente página de resultados en la lista. Si está vacío, significa que no hay más retenciones para mostrar.
|
Permisos de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/ediscovery.readonlyhttps://www.googleapis.com/auth/ediscovery
Para obtener más información, consulta la Guía de autorización.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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)."]]
