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

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