REST Resource: matters.holds

リソース: 保留

記録保持(リティゲーション ホールド)記録保持を適用すると、指定した Google Workspace サービスで、特定のアカウントや組織部門のすべてのメンバーのデータがパージされなくなります。

Vault リソースを扱うには、アカウントに必要な Vault 権限と案件へのアクセス権が必要です。案件にアクセスするには、そのアカウントが案件を作成しているか、案件を共有しているか、全案件の閲覧権限を持っている必要があります。

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「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

accounts[]

object (HeldAccount)

設定すると、指定したアカウントに記録保持が適用され、orgUnit は空である必要があります。

orgUnit

object (HeldOrgUnit)

設定すると、組織部門のすべてのメンバーに記録保持が適用され、アカウントは空である必要があります。このプロパティは変更可能です。グループの記録保持(リティゲーション ホールド)の場合は、アカウントを設定します。

corpus

enum (CorpusType)

検索対象のサービス。

query

object (CorpusQuery)

サービス固有のオプション。設定する場合は、CorpusQueryCorpusType と一致する必要があります。

HeldOrgUnit

記録保持の対象となる組織部門。この構造は変更できません。

JSON 表現
{
  "orgUnitId": string,
  "holdTime": string
}
フィールド
orgUnitId

string

Admin SDK によって提供される組織部門の不変の ID。

holdTime

string (Timestamp format)

組織部門が保留になった日時。このプロパティは変更できません。

RFC3339 UTC「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)
  }
  // End of list of possible types for union field corpus_query.
}
フィールド
共用体フィールド corpus_query。設定する場合は、サービスタイプと一致する必要があります。corpus_query は次のいずれかになります。
driveQuery

object (HeldDriveQuery)

ドライブの記録保持のサービス固有のオプション。設定する場合は、CorpusTypeDRIVE にする必要があります。

mailQuery

object (HeldMailQuery)

Gmail の記録保持(リティゲーション ホールド)用のサービス固有のオプション。設定する場合は、CorpusTypeMail にする必要があります。

groupsQuery

object (HeldGroupsQuery)

グループの記録保持(リティゲーション ホールド)のサービス固有のオプション。設定する場合は、CorpusTypeGROUPS にする必要があります。

hangoutsChatQuery

object (HeldHangoutsChatQuery)

チャットの記録保持(リティゲーション ホールド)用のサービス固有のオプション。設定する場合は、CorpusTypeHANGOUTS_CHAT にする必要があります。

voiceQuery

object (HeldVoiceQuery)

Voice の記録保持(リティゲーション ホールド)に関するサービス固有のオプション。設定する場合は、CorpusTypeVOICE にする必要があります。

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「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

endTime

string (Timestamp format)

クエリの終了時間。GMT で指定します。値は指定した日付の午前 12 時に四捨五入されます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "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 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

endTime

string (Timestamp format)

クエリの終了時間。GMT で指定します。値は指定した日付の午前 12 時に四捨五入されます。

RFC3339 UTC「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)

記録保持の対象となるデータ型のリスト。空にすることはできません。順序は関係なく、重複は無視されます。

Methods

addHeldAccounts

アカウントを記録保持(リティゲーション ホールド)に追加します。

create

指定した案件に記録保持を作成します。

delete

指定した記録保持を削除し、記録保持の適用対象となっているアカウントまたは組織部門を解除します。

get

指定された保留を取得します。

list

案件の記録保持を一覧表示します。

removeHeldAccounts

指定したアカウントを記録保持から削除します。

update

記録保持のスコープ(組織部門またはアカウント)とクエリ パラメータを更新します。