REST Resource: matters.holds

资源：预授权

保全。保全可防止指定的 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 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："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 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："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 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
endTime

string (Timestamp format)

查询的结束时间。请以格林尼治标准时间指定。该值会四舍五入到指定日期的零点。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："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) 指定。该值会四舍五入到指定日期的零点。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
endTime

string (Timestamp format)

查询的结束时间。请以格林尼治标准时间指定。该值会四舍五入到指定日期的零点。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："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

 更新保全的范围（组织部门或账号）和查询参数。