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)

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

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 목록 요청당 Chat 스페이스 500개에서 내보낼 수 있습니다.

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"] 과 ["New","Zealand"] "New Zealand": 'New and good Zealand'와 모두 일치: 이후 날짜로만 일치

peopleQuery[]

string

참석자가 지정된 집합의 모든 단어를 포함하는 일정과 일치합니다. 세트의 항목은 'and'로 간주됩니다.

minusWords[]

string

제목, 설명, 위치 또는 참석자의 특정 집합에 포함된 단어를 전혀 포함하지 않는 일정만 일치합니다. 세트의 항목은 'or'로 간주됩니다.

responseStatuses[]

enum (AttendeeResponse)

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

versionDate

string (Timestamp format)

캘린더 일정의 현재 버전을 검색하되 지정된 날짜의 오전 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 참가자가 참석할 것으로 예상합니다.