REST Resource: matters.holds

資源:Hold

保留。訴訟保留可禁止指定的 Google Workspace 服務清除特定帳戶或機構單位所有成員的資料。

如要使用保管箱資源,帳戶必須具備必要的保管箱權限和案件存取權。如要存取案件,帳戶必須建立該案件、已與他們共用案件,或是具備「查看所有案件」權限。

JSON 表示法
{
  "holdId": string,
  "name": string,
  "updateTime": string,
  "accounts": [
    {
      object (HeldAccount)
    }
  ],
  "orgUnit": {
    object (HeldOrgUnit)
  },
  "corpus": enum (CorpusType),
  "query": {
    object (CorpusQuery)
  }
}
欄位
holdId

string

保留項目的專屬 ID (不可變更)。在建立時指派。

name

string

保留項目的名稱。

updateTime

string (Timestamp format)

上次修改這項訴訟保留的時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

accounts[]

object (HeldAccount)

如果已設定,訴訟保留會套用至指定帳戶,且 orgUnit 必須留空。

orgUnit

object (HeldOrgUnit)

如果已設定,訴訟保留會套用至機構單位中的所有成員,而且帳戶必須留空。這項屬性可變動。如要設定群組訴訟保留,請設定「帳戶」

corpus

enum (CorpusType)

要搜尋的服務,

query

object (CorpusQuery)

服務專屬選項。如果設定,CorpusQuery 必須與 CorpusType 相符。

HeldOrgUnit

套用訴訟保留的機構單位。此結構無法變更。

JSON 表示法
{
  "orgUnitId": string,
  "holdTime": string
}
欄位
orgUnitId

string

Admin SDK 提供的機構單位不可變 ID。

holdTime

string (Timestamp format)

機構單位的訴訟保留狀態。這個屬性無法變更。

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

CorpusQuery

保留專屬服務選項。

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.
}
欄位
聯集欄位 corpus_query。如有設定,此項目必須與服務類型相符。corpus_query 只能是下列其中一項:
driveQuery

object (HeldDriveQuery)

雲端硬碟保留功能的服務專屬選項。如果已設定,CorpusType 必須為 DRIVE

mailQuery

object (HeldMailQuery)

適用於 Gmail 訴訟保留的服務選項。如果已設定,CorpusType 必須為 MAIL

groupsQuery

object (HeldGroupsQuery)

適用於網路論壇訴訟保留的服務選項。如果已設定,CorpusType 必須為 GROUPS

hangoutsChatQuery

object (HeldHangoutsChatQuery)

Chat 訴訟保留的服務專屬選項。如果已設定,CorpusType 必須為 HANGOUTS_CHAT

voiceQuery

object (HeldVoiceQuery)

語音服務保留功能的服務專屬選項。如果已設定,CorpusType 必須為 VOICE

calendarQuery

object (HeldCalendarQuery)

日曆暫緩功能的服務專屬選項。如要設定,則 CorpusType 必須為 calendar

HeldDriveQuery

雲端硬碟訴訟保留選項。

JSON 表示法
{
  "includeTeamDriveFiles": boolean,
  "includeSharedDriveFiles": boolean
}
欄位
includeTeamDriveFiles
(deprecated)

boolean

如要將小組雲端硬碟中的檔案納入保留項目,請將值設為 true

includeSharedDriveFiles

boolean

如要將共用雲端硬碟中的檔案納入保留項目,請將此值設為 true

HeldMailQuery

查詢 Gmail 訴訟保留資料的選項。

JSON 表示法
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
欄位
terms

string

搜尋運算子:用於調整訴訟保留所涵蓋的郵件。

startTime

string (Timestamp format)

查詢的開始時間。請以格林威治標準時間 (GMT) 為準。這個值會四捨五入至指定日期的凌晨 12 點。

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

endTime

string (Timestamp format)

查詢的結束時間。請以格林威治標準時間 (GMT) 指定。值會四捨五入至指定日期的 12 點。

RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

HeldGroupsQuery

群組訴訟保留的查詢選項。

JSON 表示法
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
欄位
terms

string

搜尋運算子:用於調整訴訟保留所涵蓋的郵件。

startTime

string (Timestamp format)

查詢的開始時間。請以格林威治標準時間 (GMT) 為準。值會四捨五入至指定日期的 12 點。

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

endTime

string (Timestamp format)

查詢的結束時間。請以格林威治標準時間 (GMT) 指定。值會四捨五入至指定日期的 12 點。

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

HeldHangoutsChatQuery

Chat 訴訟保留選項。

JSON 表示法
{
  "includeRooms": boolean
}
欄位
includeRooms

boolean

如要納入使用者所屬的 Chat 聊天室訊息,請設為 true

HeldVoiceQuery

Voice 保留選項。

JSON 表示法
{
  "coveredData": [
    enum (VoiceCoveredData)
  ]
}
欄位
coveredData[]

enum (VoiceCoveredData)

這項資料保留措施涵蓋的資料類型清單。不得空白。順序無關緊要,且系統會忽略重複項目。

HeldCalendarQuery

這個類型沒有任何欄位。

日曆保留功能的選項。

方法

addHeldAccounts

將帳戶新增至訴訟保留。

create

在指定案件中建立訴訟保留。

delete

移除指定的訴訟保留,並釋出適用訴訟保留的帳戶或機構單位。

get

取得指定的保留。

list

列出案件中的訴訟保留。

removeHeldAccounts

從保留狀態中移除指定的帳戶。

update

更新訴訟保留的範圍 (機構單位或帳戶) 和查詢參數。