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 purger les 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)

Date de la dernière modification de cette retenue.

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 et le champ comptes doit être vide. Cette propriété est modifiable. Pour les obligations de conservation Groupes, définissez des comptes.
corpus

enum (CorpusType)

Service à rechercher.
query

object (CorpusQuery)

Options spécifiques au service. Si elle est définie, 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 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 réservations.

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. Si défini, CorpusType doit être DRIVE.
mailQuery

object (HeldMailQuery)

Options spécifiques au service pour les procédures de préservation à titre conservatoire Gmail S'il est défini, la valeur de CorpusType doit être MAIL.
groupsQuery

object (HeldGroupsQuery)

Options spécifiques au service pour les réservations Groups 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. Si défini, CorpusType doit être 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 Si défini, CorpusType doit être CALENDAR.

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 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

Les opérateurs de recherche utilisés pour affiner les messages concernés par la conservation.
startTime

string (Timestamp format)

Heure de début de la requête. Spécifiez-le en GMT. La valeur est arrondie à minuit pour 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. Spécifiez-le en GMT. La valeur est arrondie à minuit pour 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. Spécifiez-le en 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. Spécifiez-le en GMT. La valeur est arrondie à minuit pour 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 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 mises en attente Voice.

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

enum (VoiceCoveredData)

Liste des types de données concernés par la retenue. 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 relatives 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 associées à un litige.

removeHeldAccounts

 Supprime les comptes spécifiés d'une retenue.

update

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