Query

검색 및 내보내기에 사용되는 쿼리 정의입니다.

JSON 표현
{
  "corpus": enum (CorpusType),
  "dataScope": enum (DataScope),
  "searchMethod": enum (SearchMethod),
  "method": enum (SearchMethod),
  "terms": string,
  "startTime": string,
  "endTime": string,
  "teamDriveInfo": {
    object (TeamDriveInfo)
  },
  "timeZone": string,

  // Union field search_method_field can be only one of the following:
  "accountInfo": {
    object (AccountInfo)
  },
  "orgUnitInfo": {
    object (OrgUnitInfo)
  },
  "sharedDriveInfo": {
    object (SharedDriveInfo)
  },
  "hangoutsChatInfo": {
    object (HangoutsChatInfo)
  },
  "sitesUrlInfo": {
    object (SitesUrlInfo)
  }
  // End of list of possible types for union field search_method_field.

  // Union field corpus_options_field can be only one of the following:
  "mailOptions": {
    object (MailOptions)
  },
  "driveOptions": {
    object (DriveOptions)
  },
  "hangoutsChatOptions": {
    object (HangoutsChatOptions)
  },
  "voiceOptions": {
    object (VoiceOptions)
  },
  "calendarOptions": {
    object (CalendarOptions)
  }
  // End of list of possible types for union field corpus_options_field.
}
필드
corpus

enum (CorpusType)

검색할 Google Workspace 서비스입니다.

dataScope

enum (DataScope)

검색할 데이터 소스입니다.

searchMethod
(deprecated)

enum (SearchMethod)

사용할 검색 방법입니다.

method

enum (SearchMethod)

검색할 항목입니다. 이 필드는 공유 드라이브를 지원하기 위해 searchMethod를 대체합니다. searchMethodTEAM_DRIVE인 경우 이 필드의 응답은 SHARED_DRIVE입니다.

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"입니다.

teamDriveInfo
(deprecated)

object (TeamDriveInfo)

SearchMethodTEAM_DRIVE인 경우 필수입니다.

timeZone

string

시간대 이름입니다. 'America/Los_Angeles' 같은 IANA TZ 이름이어야 합니다. 시간대 이름 목록은 시간대를 참고하세요. Vault에서 시간대를 사용하는 방법에 대한 자세한 내용은 Vault 고객센터를 참고하세요.

통합 필드 search_method_field. 필요한 경우 검색할 항목 search_method_field의 세부정보는 다음 중 하나여야 합니다.
accountInfo

object (AccountInfo)

SearchMethodACCOUNT인 경우 필요합니다.

orgUnitInfo

object (OrgUnitInfo)

SearchMethodORG_UNIT인 경우 필요합니다.

sharedDriveInfo

object (SharedDriveInfo)

SearchMethodSHARED_DRIVE인 경우 필수입니다.

hangoutsChatInfo

object (HangoutsChatInfo)

SearchMethodROOM인 경우 필요합니다. (읽기 전용)

sitesUrlInfo

object (SitesUrlInfo)

SearchMethodSITES_URL인 경우에 필요합니다.

통합 필드 corpus_options_field. 특정 서비스의 추가 검색 옵션 corpus_options_field은 다음 중 하나여야 합니다.
mailOptions

object (MailOptions)

Gmail 검색 관련 옵션을 설정합니다.

driveOptions

object (DriveOptions)

Drive 검색 관련 옵션을 설정합니다.

hangoutsChatOptions

object (HangoutsChatOptions)

Chat 검색 관련 옵션을 설정합니다. (읽기 전용)

voiceOptions

object (VoiceOptions)

음성 검색 관련 옵션을 설정합니다.

calendarOptions

object (CalendarOptions)

캘린더 검색 관련 옵션을 설정합니다.

DataScope

검색할 데이터 소스입니다.

열거형
DATA_SCOPE_UNSPECIFIED 지정된 데이터 소스가 없습니다.
ALL_DATA 사용 가능한 모든 데이터
HELD_DATA 보존 조치가 적용된 데이터만
UNPROCESSED_DATA Vault에서 아직 처리하지 않은 데이터만 포함됩니다. (Gmail 및 그룹스만 해당)

SearchMethod

검색의 항목 유형입니다.

열거형
SEARCH_METHOD_UNSPECIFIED 검색 방법을 지정하지 않으면 거부됩니다.
ACCOUNT AccountInfo에 지정된 계정의 데이터를 검색합니다.
ORG_UNIT OrgUnitInfo에 지정된 조직 단위에 있는 모든 계정의 데이터를 검색합니다.
TEAM_DRIVE

teamDriveInfo에 지정된 팀 드라이브에서 데이터를 검색합니다.

ENTIRE_ORG 조직의 모든 계정 데이터를 검색합니다. Gmail에서만 지원됩니다. 이 플래그를 지정하면 AccountInfo 또는 OrgUnitInfo를 지정할 필요가 없습니다.
ROOM HangoutsChatInfo에 지정된 Chat 스페이스에서 메시지를 검색합니다.
SITES_URL SitesUrlInfo에 지정된 게시된 사이트 URL로 사이트를 검색합니다.
SHARED_DRIVE SharedDriveInfo에 지정된 공유 드라이브에서 파일을 검색합니다.

AccountInfo

검색할 계정

JSON 표현
{
  "emails": [
    string
  ]
}
필드
emails[]

string

검색할 계정 집합입니다.

OrgUnitInfo

검색할 조직 단위

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

string

검색할 조직 단위의 이름으로, Admin SDK Directory API에서 제공합니다.

SharedDriveInfo

검색할 공유 드라이브

JSON 표현
{
  "sharedDriveIds": [
    string
  ]
}
필드
sharedDriveIds[]

string

Drive API에서 제공하는 공유 드라이브 ID 목록

HangoutsChatInfo

검색할 Chat 스페이스

JSON 표현
{
  "roomId": [
    string
  ]
}
필드
roomId[]

string

Chat API에서 제공하는 Chat 스페이스 ID 목록입니다. 요청당 500개의 Chat 스페이스에서 내보낼 수 있습니다.

SitesUrlInfo

검색할 새 Google Sites의 게시된 사이트 URL

JSON 표현
{
  "urls": [
    string
  ]
}
필드
urls[]

string

게시된 사이트 URL의 목록입니다.

TeamDriveInfo

검색할 팀 드라이브

JSON 표현
{
  "teamDriveIds": [
    string
  ]
}
필드
teamDriveIds[]
(deprecated)

string

팀 드라이브 ID 목록(Drive API에서 제공)

MailOptions

Gmail 검색 추가 옵션

JSON 표현
{
  "excludeDrafts": boolean,
  "clientSideEncryptedOption": enum (ClientSideEncryptedOption)
}
필드
excludeDrafts

boolean

임시보관 메일을 제외하려면 true로 설정합니다.

clientSideEncryptedOption

enum (ClientSideEncryptedOption)

결과에 암호화된 콘텐츠, 암호화되지 않은 콘텐츠 또는 둘 다를 포함해야 하는지 지정합니다. 기본적으로 둘 다 포함됩니다.

ClientSideEncryptedOption

조직에서 Google Workspace 클라이언트 측 암호화를 사용하는 경우 콘텐츠의 암호화 상태

열거형
CLIENT_SIDE_ENCRYPTED_OPTION_UNSPECIFIED 암호화 상태가 지정되지 않았습니다. 결과에는 클라이언트 측에서 암호화된 콘텐츠와 암호화되지 않은 콘텐츠가 모두 포함됩니다.
CLIENT_SIDE_ENCRYPTED_OPTION_ANY 결과에 클라이언트 측에서 암호화된 콘텐츠와 암호화되지 않은 콘텐츠를 모두 포함합니다.
CLIENT_SIDE_ENCRYPTED_OPTION_ENCRYPTED 클라이언트 측에서 암호화된 콘텐츠만 포함합니다.
CLIENT_SIDE_ENCRYPTED_OPTION_UNENCRYPTED 암호화되지 않은 콘텐츠만 포함합니다.

DriveOptions

Drive 검색 추가 옵션

JSON 표현
{
  "versionDate": string,
  "includeTeamDrives": boolean,
  "includeSharedDrives": boolean,
  "clientSideEncryptedOption": enum (ClientSideEncryptedOption)
}
필드
versionDate

string (Timestamp format)

Drive 파일의 현재 버전을 검색하지만 지정된 날짜의 오전 12시(UTC) 이전에 저장된 마지막 버전의 콘텐츠를 내보냅니다. 날짜를 UTC로 입력하세요.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

includeTeamDrives
(deprecated)

boolean

팀 드라이브를 포함하려면 true로 설정합니다.

includeSharedDrives

boolean

공유 드라이브를 포함하려면 true로 설정합니다.

clientSideEncryptedOption

enum (ClientSideEncryptedOption)

결과에 Google Workspace 클라이언트 측 암호화 콘텐츠로 암호화된 콘텐츠만 포함할지, 암호화되지 않은 콘텐츠만 포함하거나 둘 다 포함할지 설정합니다. 기본값은 '둘 다'입니다. 현재 Drive에서 지원됩니다.

HangoutsChatOptions

Google Chat 검색의 추가 옵션

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

boolean

계정 또는 조직 단위로 검색하는 경우 회의실을 포함하려면 true로 설정합니다.

VoiceOptions

음성 검색을 위한 추가 옵션

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

enum (VoiceCoveredData)

검색할 데이터 유형

CalendarOptions

Calendar 검색의 추가 옵션

JSON 표현
{
  "locationQuery": [
    string
  ],
  "peopleQuery": [
    string
  ],
  "minusWords": [
    string
  ],
  "responseStatuses": [
    enum (AttendeeResponse)
  ],
  "versionDate": string
}
필드
locationQuery[]

string

지정된 집합의 모든 단어가 해당 위치에 포함된 이벤트만 일치합니다. 문자열에 따옴표로 묶인 구문이 포함된 경우 이 메서드는 해당 위치에 정확한 구문이 포함된 이벤트만 일치시킵니다. 세트의 항목은 'and'로 간주됩니다.

단어 분할 예: ["New Zealand"] vs ["New","Zealand"] "New Zealand": "New andBetter Zealand" 모두 일치: 이후 단어만 일치

peopleQuery[]

string

지정된 집합의 단어가 모두 포함된 참석자가 있는 이벤트만 일치합니다. 세트의 항목은 'and'로 간주됩니다.

minusWords[]

string

제목, 설명, 위치 또는 참석자에 지정된 집합에 포함된 단어가 하나도 포함되지 않은 이벤트만 일치합니다. 세트의 항목은 '또는'으로 간주됩니다.

responseStatuses[]

enum (AttendeeResponse)

관리자가 이러한 응답 중 하나를 제공한 이벤트만 일치합니다. 집합이 비어 있거나 ATTENDEE_응답_UNSPECIFIED를 포함하는 경우 응답에 대한 필터링은 수행되지 않습니다.

versionDate

string (Timestamp format)

Calendar 일정의 현재 버전을 검색하되 지정된 날짜의 오전 12시(UTC) 이전에 저장된 마지막 버전의 콘텐츠를 내보냅니다. 날짜를 UTC로 입력합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

AttendeeResponse

초대에 대한 사용자 응답입니다.

열거형
ATTENDEE_RESPONSE_UNSPECIFIED 참석자 응답이 지정되지 않았습니다. 이 속성을 설정하면 응답에 대한 필터링이 수행되지 않으며 쿼리 옵션에 포함된 다른 모든 참석자 응답이 무시됩니다.
ATTENDEE_RESPONSE_NEEDS_ACTION 참여자가 초대되었지만 아직 응답하지 않았습니다.
ATTENDEE_RESPONSE_ACCEPTED 참석자가 참석할 계획입니다.
ATTENDEE_RESPONSE_DECLINED 참가자가 참석할 계획이 없습니다.
ATTENDEE_RESPONSE_TENTATIVE 참석자가 참석할 것으로 예상합니다.