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)

이 보류가 마지막으로 수정된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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)

설정된 경우 보존 조치가 조직 단위의 모든 구성원에게 적용되며 accounts가 비어 있어야 합니다. 이 속성은 변경 가능합니다. 그룹 보존 조치의 경우 accounts를 설정합니다.
corpus

enum (CorpusType)

검색할 서비스입니다.
query

object (CorpusQuery)

서비스별 옵션입니다. 설정된 경우 CorpusQuery는 CorpusType과 일치해야 합니다.

HeldOrgUnit

보존 대상에 포함된 조직 단위입니다. 이 구조는 변경할 수 없습니다.

JSON 표현 
{
  "orgUnitId": string,
  "holdTime": string
}
필드
orgUnitId

string

Admin SDK에서 제공하는 조직 단위의 변경 불가능한 ID입니다.
holdTime

string (Timestamp format)

조직 단위에 보존 조치가 적용된 시간입니다. 이 속성은 변경할 수 없습니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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)

Drive 보관의 서비스별 옵션입니다. 설정된 경우 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)

Calendar 보관의 서비스별 옵션입니다. 설정된 경우 CorpusType은 CALENDAR여야 합니다.
geminiQuery

object (HeldGeminiQuery)

Gemini 보류의 서비스별 옵션입니다. 설정된 경우 CorpusType은 GEMINI여야 합니다.

HeldDriveQuery

Drive 보존 옵션입니다.

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시로 반올림됩니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
endTime

string (Timestamp format)

쿼리의 종료 시간입니다. GMT로 지정합니다. 값이 지정된 날짜의 오전 12시로 반올림됩니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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로 지정합니다. 값이 지정된 날짜의 오전 12시로 반올림됩니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
endTime

string (Timestamp format)

쿼리의 종료 시간입니다. GMT로 지정합니다. 값이 지정된 날짜의 오전 12시로 반올림됩니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

HeldHangoutsChatQuery

채팅 보존 옵션입니다.

JSON 표현 
{
  "includeRooms": boolean
}
필드
includeRooms

boolean

사용자가 속해 있던 Chat 스페이스의 메시지를 포함하려면 true로 설정합니다.

HeldVoiceQuery

음성 보류 옵션입니다.

JSON 표현 
{
  "coveredData": [
    enum (VoiceCoveredData)
  ]
}
필드
coveredData[]

enum (VoiceCoveredData)

보관 대상에 포함된 데이터 유형 목록입니다. 비워둘 수 없습니다. 순서는 중요하지 않으며 중복은 무시됩니다.

HeldCalendarQuery

이 유형에는 필드가 없습니다.

Calendar 보관 옵션입니다.

HeldGeminiQuery

이 유형에는 필드가 없습니다.

Gemini 보류 옵션입니다.

메서드

addHeldAccounts

 보존 조치에 계정을 추가합니다.

create

 지정된 법적 사안에서 보존 조치를 만듭니다.

delete

 지정된 보존 조치를 삭제하고 보존 조치가 적용된 계정 또는 조직 단위를 해제합니다.

get

 지정된 보류를 가져옵니다.

list

 법적 사안의 보존 조치를 나열합니다.

removeHeldAccounts

 보류에서 지정된 계정을 삭제합니다.

update

 보관의 범위 (조직 단위 또는 계정) 및 쿼리 매개변수를 업데이트합니다.