REST Resource: matters.holds

リソース: Hold

保留中です。記録保持により、指定した 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)

この保留が最後に変更された日時。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
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)

組織部門が記録保持（リティゲーション ホールド）の対象になった日時。このプロパティは変更できません。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

CorpusQuery

保留のサービス固有のオプション。

JSON 表現 
{

  "driveQuery": {
    object (HeldDriveQuery)
  },
  "mailQuery": {
    object (HeldMailQuery)
  },
  "groupsQuery": {
    object (HeldGroupsQuery)
  },
  "hangoutsChatQuery": {
    object (HeldHangoutsChatQuery)
  },
  "voiceQuery": {
    object (HeldVoiceQuery)
  },
  "calendarQuery": {
    object (HeldCalendarQuery)
  },
  "geminiQuery": {
    object (HeldGeminiQuery)
  }
}
フィールド
共用体フィールド 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)

Voice の保留に関するサービス固有のオプション。設定されている場合、CorpusType は VOICE である必要があります。
calendarQuery

object (HeldCalendarQuery)

カレンダーの保持に関するサービス固有のオプション。設定されている場合、CorpusType は CALENDAR にする必要があります。
geminiQuery

object (HeldGeminiQuery)

Gemini の保留に関するサービス固有のオプション。設定されている場合、CorpusType は GEMINI にする必要があります。

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 で指定します。値は指定した日付の午前 0 時に丸められます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

クエリの終了時間。GMT で指定します。値は指定した日付の午前 0 時に丸められます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

HeldGroupsQuery

グループの記録保持のクエリ オプション。

JSON 表現 
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
フィールド
terms

string

ホールドの対象となるメッセージを絞り込むために使用される検索演算子。
startTime

string (Timestamp format)

クエリの開始時刻。GMT で指定します。値は指定した日付の午前 0 時に丸められます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

クエリの終了時間。GMT で指定します。値は指定した日付の午前 0 時に丸められます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

HeldHangoutsChatQuery

Chat の記録保持のオプション。

JSON 表現 
{
  "includeRooms": boolean
}
フィールド
includeRooms

boolean

ユーザーがメンバーだった Chat スペースのメッセージを含めるには、true に設定します。

HeldVoiceQuery

音声保留のオプション。

JSON 表現 
{
  "coveredData": [
    enum (VoiceCoveredData)
  ]
}
フィールド
coveredData[]

enum (VoiceCoveredData)

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

HeldCalendarQuery

この型にはフィールドがありません。

カレンダーの保留のオプション。

HeldGeminiQuery

この型にはフィールドがありません。

Gemini の保留のオプション。

メソッド

addHeldAccounts

 アカウントを記録保持に追加します。

create

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

delete

 指定した保持を削除し、保持の対象となるアカウントまたは組織部門を解放します。

get

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

list

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

removeHeldAccounts

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

update

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