REST Resource: matters.holds

Ressource: obligation de conservation

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

Pour utiliser les ressources Vault, le compte doit disposer des droits Vault requis et d'un accès au litige. Pour pouvoir accéder à un litige, le compte doit l'avoir créé, le partager 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 unique et immuable de l'obligation de conservation. Attribué lors de la création.

name

string

Nom de l'obligation de conservation.

updateTime

string (Timestamp format)

Dernière fois que cette obligation de conservation a été modifiée.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

accounts[]

object (HeldAccount)

Si elle est définie, l'obligation de conservation s'applique aux comptes spécifiés et le champ 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. Le champ accounts doit donc être vide. Cette propriété est modifiable. Pour les obligations de conservation Groupes, définissez des comptes.

corpus

enum (CorpusType)

Service concerné par la recherche.

query

object (CorpusQuery)

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

HeldOrgUnit

Unité organisationnelle concernée 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)

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

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. 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)
  },
  "calendarQuery": {
    object (HeldCalendarQuery)
  }
  // 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, la valeur de CorpusType doit être Drive.

mailQuery

object (HeldMailQuery)

Options spécifiques au service 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, CorpusType doit être défini sur GROUPS.

hangoutsChatQuery

object (HeldHangoutsChatQuery)

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

voiceQuery

object (HeldVoiceQuery)

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

calendarQuery

object (HeldCalendarQuery)

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

HeldDriveQuery

Options des obligations de conservation Drive.

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

boolean

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

includeSharedDriveFiles

boolean

Pour inclure des fichiers de 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 utilisés pour affiner les messages concernés par l'obligation de conservation

startTime

string (Timestamp format)

Heure de début de la requête. Indiquez l'heure GMT. La valeur est arrondie à minuit à la date spécifiée.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Heure de fin de la requête. Indiquez l'heure GMT. La valeur est arrondie à minuit à la date spécifiée.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. 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 utilisés pour affiner les messages concernés par l'obligation de conservation

startTime

string (Timestamp format)

Heure de début de la requête. Indiquez l'heure GMT. La valeur est arrondie à minuit à la date spécifiée.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Heure de fin de la requête. Indiquez l'heure GMT. La valeur est arrondie à minuit à la date spécifiée.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

HeldHangoutsChatQuery

Options des 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 ce paramètre sur true.

HeldVoiceQuery

Options des obligations de conservation Voice.

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

enum (VoiceCoveredData)

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

HeldCalendarQuery

Ce type ne comporte aucun champ.

Options liées aux obligations de conservation Agenda.

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.

get

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

list

Répertorie 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.