REST Resource: matters.holds

Ressource: Patienter

En attente. Une obligation de conservation empêche le service Google Workspace spécifié de supprimer définitivement les données de comptes spécifiques ou de tous les membres d'une unité organisationnelle.

Pour utiliser des ressources Vault, le compte doit disposer des droits Vault requis et de l'accès au litige. Pour pouvoir accéder à un litige, le compte concerné doit avoir créé le litige, l'avoir partagé avec lui ou disposer du droit Afficher tous les litiges.

Représentation JSON
{
  "holdId": string,
  "name": string,
  "updateTime": string,
  "accounts": [
    {
      object (HeldAccount)
    }
  ],
  "orgUnit": {
    object (HeldOrgUnit)
  },
  "corpus": enum (CorpusType),
  "query": {
    object (CorpusQuery)
  }
}
Champs
holdId

string

Identifiant immuable unique de l'obligation de conservation. Attribué lors de la création.

name

string

Nom de l'obligation de conservation.

updateTime

string (Timestamp format)

Date de la dernière modification de cette obligation de conservation.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

accounts[]

object (HeldAccount)

Si cette règle est définie, l'obligation de conservation s'applique aux comptes spécifiés, et l'unité orgUnit doit être vide.

orgUnit

object (HeldOrgUnit)

Si elle est définie, l'obligation de conservation s'applique à tous les membres de l'unité organisationnelle, et les comptes doivent être vides. Cette propriété est modifiable. Pour les obligations de conservation Groupes, définissez des comptes.

corpus

enum (CorpusType)

Service sur lequel porte la recherche.

query

object (CorpusQuery)

Options spécifiques au service S'il est défini, CorpusQuery doit correspondre à CorpusType.

HeldOrgUnit

Unité organisationnelle couverte par une obligation de conservation. Cette structure est immuable.

Représentation JSON
{
  "orgUnitId": string,
  "holdTime": string
}
Champs
orgUnitId

string

ID immuable de l'unité organisationnelle, tel que fourni par le SDK Admin.

holdTime

string (Timestamp format)

Indique la date à laquelle l'unité organisationnelle a été mise en attente. Cette propriété est immuable.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

CorpusQuery

Options spécifiques au service pour les obligations de conservation

Représentation 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)
  }
  // End of list of possible types for union field corpus_query.
}
Champs
Champ d'union corpus_query. S'il est défini, il doit correspondre au type de service. corpus_query ne peut être qu'un des éléments suivants :
driveQuery

object (HeldDriveQuery)

Options spécifiques au service pour les obligations de conservation Drive S'il est défini, CorpusType doit être DRIVE.

mailQuery

object (HeldMailQuery)

Options spécifiques aux services pour les obligations de conservation Gmail S'il est défini, la valeur de CorpusType doit être MAIL.

groupsQuery

object (HeldGroupsQuery)

Options spécifiques au service pour les obligations de conservation Groupes S'il est défini, la valeur de CorpusType doit être GROUPS.

hangoutsChatQuery

object (HeldHangoutsChatQuery)

Options spécifiques au service pour les obligations de conservation Chat S'il est défini, CorpusType doit être HANGOUTS_CHAT.

voiceQuery

object (HeldVoiceQuery)

Options spécifiques aux services pour les obligations de conservation Voice S'il est défini, la valeur de CorpusType doit être VOICE.

HeldDriveQuery

Options pour les obligations de conservation Drive.

Représentation JSON
{
  "includeTeamDriveFiles": boolean,
  "includeSharedDriveFiles": boolean
}
Champs
includeTeamDriveFiles
(deprecated)

boolean

Pour inclure des fichiers de Drive d'équipe soumis à une obligation de conservation, définissez la valeur sur true.

includeSharedDriveFiles

boolean

Pour inclure les fichiers des Drive partagés dans l'obligation de conservation, définissez la valeur sur true.

HeldMailQuery

Options de requête pour les obligations de conservation Gmail

Représentation JSON
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
Champs
terms

string

Opérateurs de recherche permettant d'affiner les messages concernés par l'obligation de conservation.

startTime

string (Timestamp format)

Heure de début de la requête. À indiquer en GMT. La valeur est arrondie à minuit à la date spécifiée.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Heure de fin de la requête. À indiquer en GMT. La valeur est arrondie à minuit à la date spécifiée.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

HeldGroupsQuery

Options de requête pour les obligations de conservation appliquées aux groupes

Représentation JSON
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
Champs
terms

string

Opérateurs de recherche permettant d'affiner les messages concernés par l'obligation de conservation.

startTime

string (Timestamp format)

Heure de début de la requête. À indiquer en GMT. La valeur est arrondie à minuit à la date spécifiée.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Heure de fin de la requête. À indiquer en GMT. La valeur est arrondie à minuit à la date spécifiée.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

HeldHangoutsChatQuery

Options pour les obligations de conservation Chat

Représentation JSON
{
  "includeRooms": boolean
}
Champs
includeRooms

boolean

Pour inclure les messages des espaces Chat dont l'utilisateur était membre, définissez la valeur sur true.

HeldVoiceQuery

Options pour les obligations de conservation Voice.

Représentation JSON
{
  "coveredData": [
    enum (VoiceCoveredData)
  ]
}
Champs
coveredData[]

enum (VoiceCoveredData)

Liste des types de données couverts par l'obligation de conservation. Ne doit pas être vide. L'ordre n'a pas d'importance et les doublons sont ignorés.

Méthodes

addHeldAccounts

Ajoute des comptes à une obligation de conservation.

create

Crée une obligation de conservation dans le litige spécifié.

delete

Supprime l'obligation de conservation spécifiée, et libère les comptes ou l'unité organisationnelle concernés par celle-ci.

get

Récupère l'obligation de conservation spécifiée.

list

Liste les obligations de conservation d'un litige.

removeHeldAccounts

Supprime les comptes spécifiés d'une obligation de conservation.

update

Met à jour le champ d'application (unité organisationnelle ou comptes) et les paramètres de requête d'une obligation de conservation.