- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- AddHeldAccountResult
- Pruébalo
Agrega cuentas a una retención. Muestra una lista de las cuentas que se agregaron correctamente. Las cuentas solo se pueden agregar a una retención existente basada en la cuenta.
Solicitud HTTP
POST https://vault.googleapis.com/v1/matters/{matterId}/holds/{holdId}:addHeldAccounts
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros | |
|---|---|
| matterId | 
 El ID del asunto | 
| holdId | 
 El ID de retención | 
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
| Representación JSON | 
|---|
| { "emails": [ string ], "accountIds": [ string ] } | 
| Campos | |
|---|---|
| emails[] | 
 Es una lista separada por comas de los correos electrónicos de las cuentas que se agregarán a la retención. Especifica emails o accountIds, pero no ambos. | 
| accountIds[] | 
 Es una lista de los IDs de las cuentas que se deben agregar a la retención, separados por comas. Especifica emails o accountIds, pero no ambos. | 
Cuerpo de la respuesta
Es la respuesta para crear cuentas retenidas por lotes.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
| Representación JSON | 
|---|
| {
  "responses": [
    {
      object ( | 
| Campos | |
|---|---|
| responses[] | 
 Es la lista de respuestas, en el mismo orden que la solicitud por lotes. | 
Permisos de autorización
Requiere el siguiente alcance de OAuth:
- https://www.googleapis.com/auth/ediscovery
Para obtener más información, consulta la Guía de autorización.
AddHeldAccountResult
El estado de cada creación de cuenta y HeldAccount, si se realiza correctamente.
| Representación JSON | 
|---|
| { "account": { object ( | 
| Campos | |
|---|---|
| account | 
 Se muestra cuando la cuenta se crea correctamente. | 
| status | 
 Informa el estado de la solicitud. Si falla, muestra un mensaje de error. |