REST Resource: matters.holds

Recurso: Espera

Una conservación. Una conservación impide que el servicio de Google Workspace especificado borre definitivamente los datos de cuentas específicas o de todos los miembros de una unidad organizativa.

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, compartido con ella o tener el privilegio Ver todos los asuntos.

Representación JSON 
{
  "holdId": string,
  "name": string,
  "updateTime": string,
  "accounts": [
    {
      object (HeldAccount)
    }
  ],
  "orgUnit": {
    object (HeldOrgUnit)
  },
  "corpus": enum (CorpusType),
  "query": {
    object (CorpusQuery)
  }
}
Campos
holdId

string

El ID inmutable único de la conservación. Se asigna durante la creación.
name

string

Es el nombre de la conservación.
updateTime

string (Timestamp format)

La última vez que se modificó esta conservación.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
accounts[]

object (HeldAccount)

Si se establece, la conservación se aplica a las cuentas especificadas y el elemento orgUnit debe estar vacío.
orgUnit

object (HeldOrgUnit)

Si se establece, la conservación se aplica a todos los miembros de la unidad organizativa y las cuentas deben estar vacías. Esta propiedad es mutable. En el caso de las conservaciones de Grupos, establece cuentas.
corpus

enum (CorpusType)

El servicio en el que se buscará.
query

object (CorpusQuery)

Opciones específicas del servicio. Si se configura, CorpusQuery debe coincidir con CorpusType.

HeldOrgUnit

La unidad organizativa cubierta por una conservación. Esta estructura es inmutable.

Representación JSON 
{
  "orgUnitId": string,
  "holdTime": string
}
Campos
orgUnitId

string

El ID inmutable de la unidad organizativa tal como lo proporciona el SDK de Admin.
holdTime

string (Timestamp format)

Momento en el que se puso en espera la unidad organizativa. Esta propiedad es inmutable.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

CorpusQuery

Opciones específicas del servicio para las conservaciones.

Representación JSON 
{

  // Union field corpus_query can be only one of the following:
  "driveQuery": {
    object (HeldDriveQuery)
  },
  "mailQuery": {
    object (HeldMailQuery)
  },
  "groupsQuery": {
    object (HeldGroupsQuery)
  },
  "hangoutsChatQuery": {
    object (HeldHangoutsChatQuery)
  },
  "voiceQuery": {
    object (HeldVoiceQuery)
  },
  "calendarQuery": {
    object (HeldCalendarQuery)
  }
  // End of list of possible types for union field corpus_query.
}
Campos
Campo de unión corpus_query. Si se establece, debe coincidir con el tipo de servicio. Las direcciones (corpus_query) solo pueden ser una de las siguientes opciones:
driveQuery

object (HeldDriveQuery)

Opciones específicas del servicio para las conservaciones de Drive. Si se configura, CorpusType debe ser Drive.
mailQuery

object (HeldMailQuery)

Opciones específicas del servicio para las conservaciones de Gmail. Si se configura, CorpusType debe ser mail.
groupsQuery

object (HeldGroupsQuery)

Opciones específicas del servicio para las conservaciones de Grupos. Si se establece, CorpusType debe ser GRUPOS.
hangoutsChatQuery

object (HeldHangoutsChatQuery)

Opciones específicas del servicio para las conservaciones de Chat. Si se configura, CorpusType debe ser HANGOUTS_CHAT.
voiceQuery

object (HeldVoiceQuery)

Opciones específicas del servicio para las conservaciones de Voice. Si se configura, CorpusType debe ser VOICE.
calendarQuery

object (HeldCalendarQuery)

Opciones específicas del servicio para las conservaciones del Calendario. Si se establece, CorpusType debe ser CALENDAR.

HeldDriveQuery

Opciones para las conservaciones de Drive.

Representación JSON 
{
  "includeTeamDriveFiles": boolean,
  "includeSharedDriveFiles": boolean
}
Campos
includeTeamDriveFiles
(deprecated)

boolean

Para incluir los archivos en las unidades de equipo que estén en conservación, establécelo en true.
includeSharedDriveFiles

boolean

Para incluir archivos en unidades compartidas de la conservación, establécelos en true.

HeldMailQuery

Opciones de consulta para conservaciones de Gmail.

Representación JSON 
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
Campos
terms

string

Son los operadores de búsqueda que se usan para definir mejor los mensajes cubiertos por la conservación.
startTime

string (Timestamp format)

La hora de inicio de la consulta. Especifícalo en GMT. El valor se redondea a las 12 a.m. de la fecha especificada.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

La hora de finalización de la consulta. Especifícalo en GMT. El valor se redondea a las 12 a.m. de la fecha especificada.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

HeldGroupsQuery

Opciones de consulta para conservaciones grupales.

Representación JSON 
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
Campos
terms

string

Son los operadores de búsqueda que se usan para definir mejor los mensajes cubiertos por la conservación.
startTime

string (Timestamp format)

La hora de inicio de la consulta. Especifícalo en GMT. El valor se redondea a las 12 a.m. de la fecha especificada.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

La hora de finalización de la consulta. Especifícalo en GMT. El valor se redondea a las 12 a.m. de la fecha especificada.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

HeldHangoutsChatQuery

Opciones para las conservaciones de Chat.

Representación JSON 
{
  "includeRooms": boolean
}
Campos
includeRooms

boolean

Para incluir mensajes en los espacios de Chat de los que el usuario era miembro, establécelo como true.

HeldVoiceQuery

Opciones para las conservaciones por voz.

Representación JSON 
{
  "coveredData": [
    enum (VoiceCoveredData)
  ]
}
Campos
coveredData[]

enum (VoiceCoveredData)

Una lista de los tipos de datos que abarca la conservación. No debe estar vacío. El orden no importa y se ignoran los duplicados.

HeldCalendarQuery

Este tipo no tiene campos.

Opciones para las conservaciones del Calendario.

Métodos

addHeldAccounts

 Agrega cuentas a una conservación.

create

 Crea una conservación en el asunto especificado.

delete

 Quita la conservación especificada y libera las cuentas o la unidad organizativa que abarca.

get

 Obtiene la conservación especificada.

list

 Enumera las conservaciones de un asunto.

removeHeldAccounts

 Quita las cuentas especificadas de una conservación.

update

 Actualiza el permiso (unidades organizativas o cuentas) y los parámetros de consulta de una conservación.