REST Resource: matters.holds

Risorsa: Hold

Un blocco. Una conservazione impedisce al servizio Google Workspace specificato di eliminare i dati per account specifici o per tutti i membri di un'unità organizzativa.

Per utilizzare le risorse di Vault, l'account deve disporre dei privilegi di Vault richiesti e dell'accesso alla pratica. Per accedere a una pratica, l'account deve averla creata, deve averla condivisa o deve disporre del privilegio Visualizzazione di tutte le pratiche.

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

string

L'ID univoco e immutabile della sospensione. Assegnato durante la creazione.

name

string

Il nome della sospensione.

updateTime

string (Timestamp format)

L'ultima volta che questa sospensione è stata modificata.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

accounts[]

object (HeldAccount)

Se impostata, la conservazione si applica agli account specificati e orgUnit deve essere vuoto.

orgUnit

object (HeldOrgUnit)

Se impostata, la conservazione si applica a tutti i membri dell'unità organizzativa e gli account devono essere vuoti. Questa proprietà è modificabile. Per le archiviazioni a fini legali dei gruppi, imposta account.

corpus

enum (CorpusType)

Il servizio in cui eseguire la ricerca.

query

object (CorpusQuery)

Opzioni specifiche del servizio. Se impostata, CorpusQuery deve corrispondere a CorpusType.

HeldOrgUnit

L'unità organizzativa coperta da una sospensione. Questa struttura è immutabile.

Rappresentazione JSON
{
  "orgUnitId": string,
  "holdTime": string
}
Campi
orgUnitId

string

L'ID immutabile dell'unità organizzativa fornito dall'SDK Admin.

holdTime

string (Timestamp format)

Quando è stata applicata la conservazione all'unità organizzativa. Questa proprietà è immutabile.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

CorpusQuery

Opzioni specifiche del servizio per le sospensioni.

Rappresentazione JSON
{

  "driveQuery": {
    object (HeldDriveQuery)
  },
  "mailQuery": {
    object (HeldMailQuery)
  },
  "groupsQuery": {
    object (HeldGroupsQuery)
  },
  "hangoutsChatQuery": {
    object (HeldHangoutsChatQuery)
  },
  "voiceQuery": {
    object (HeldVoiceQuery)
  },
  "calendarQuery": {
    object (HeldCalendarQuery)
  },
  "geminiQuery": {
    object (HeldGeminiQuery)
  }
}
Campi
Campo unione corpus_query. Se impostato, deve corrispondere al tipo di servizio. corpus_query può essere solo uno dei seguenti tipi:
driveQuery

object (HeldDriveQuery)

Opzioni specifiche del servizio per le sospensioni di Drive. Se impostato, CorpusType deve essere DRIVE.

mailQuery

object (HeldMailQuery)

Opzioni specifiche del servizio per i blocchi di Gmail. Se impostato, CorpusType deve essere MAIL.

groupsQuery

object (HeldGroupsQuery)

Opzioni specifiche del servizio per le sospensioni di Gruppi. Se impostato, CorpusType deve essere GRUPPI.

hangoutsChatQuery

object (HeldHangoutsChatQuery)

Opzioni specifiche del servizio per i blocchi di Chat. Se impostato, CorpusType deve essere HANGOUTS_CHAT.

voiceQuery

object (HeldVoiceQuery)

Opzioni specifiche del servizio per le prenotazioni di Voice. Se impostato, CorpusType deve essere VOICE.

calendarQuery

object (HeldCalendarQuery)

Opzioni specifiche del servizio per le sospensioni di Calendar. Se impostato, CorpusType deve essere CALENDAR.

geminiQuery

object (HeldGeminiQuery)

Opzioni specifiche del servizio per le sospensioni di Gemini. Se impostato, CorpusType deve essere GEMINI.

HeldDriveQuery

Opzioni per le archiviazioni a fini legali di Drive.

Rappresentazione JSON
{
  "includeTeamDriveFiles": boolean,
  "includeSharedDriveFiles": boolean
}
Campi
includeTeamDriveFiles
(deprecated)

boolean

Per includere i file nei Drive del team nella sospensione, imposta il valore su true.

includeSharedDriveFiles

boolean

Per includere i file nei Drive condivisi nella sospensione, imposta il valore su true.

HeldMailQuery

Opzioni di query per i blocchi di Gmail.

Rappresentazione JSON
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
Campi
terms

string

Gli operatori di ricerca utilizzati per perfezionare i messaggi coperti dalla sospensione.

startTime

string (Timestamp format)

L'ora di inizio della query. Specifica in GMT. Il valore viene arrotondato alle ore 00:00 della data specificata.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

L'ora di fine della query. Specifica in GMT. Il valore viene arrotondato alle ore 00:00 della data specificata.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

HeldGroupsQuery

Opzioni di query per i blocchi di gruppo.

Rappresentazione JSON
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
Campi
terms

string

Gli operatori di ricerca utilizzati per perfezionare i messaggi coperti dalla sospensione.

startTime

string (Timestamp format)

L'ora di inizio della query. Specifica in GMT. Il valore viene arrotondato alle ore 00:00 della data specificata.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

L'ora di fine della query. Specifica in GMT. Il valore viene arrotondato alle ore 00:00 della data specificata.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

HeldHangoutsChatQuery

Opzioni per i blocchi di Chat.

Rappresentazione JSON
{
  "includeRooms": boolean
}
Campi
includeRooms

boolean

Per includere i messaggi negli spazi di Chat di cui l'utente era membro, imposta il valore su true.

HeldVoiceQuery

Opzioni per le prenotazioni vocali.

Rappresentazione JSON
{
  "coveredData": [
    enum (VoiceCoveredData)
  ]
}
Campi
coveredData[]

enum (VoiceCoveredData)

Un elenco dei tipi di dati coperti dalla sospensione. Non deve essere vuoto. L'ordine non è importante e i duplicati vengono ignorati.

HeldCalendarQuery

Questo tipo non contiene campi.

Opzioni per le sospensioni di Calendar.

HeldGeminiQuery

Questo tipo non contiene campi.

Opzioni per le attese di Gemini.

Metodi

addHeldAccounts

Aggiunge account a una conservazione.

create

Crea un blocco nella pratica specificata.

delete

Rimuove la conservazione specificata e rilascia gli account o l'unità organizzativa coperti dalla conservazione.

get

Recupera la sospensione specificata.

list

Elenca i blocchi in una pratica.

removeHeldAccounts

Rimuove gli account specificati da una sospensione.

update

Aggiorna l'ambito (unità organizzativa o account) e i parametri di query di una conservazione.