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,

  "accountInfo": {
    object (AccountInfo)
  },
  "orgUnitInfo": {
    object (OrgUnitInfo)
  },
  "sharedDriveInfo": {
    object (SharedDriveInfo)
  },
  "hangoutsChatInfo": {
    object (HangoutsChatInfo)
  },
  "sitesUrlInfo": {
    object (SitesUrlInfo)
  },
  "driveDocumentInfo": {
    object (DriveDocumentInfo)
  }

  "mailOptions": {
    object (MailOptions)
  },
  "driveOptions": {
    object (DriveOptions)
  },
  "hangoutsChatOptions": {
    object (HangoutsChatOptions)
  },
  "voiceOptions": {
    object (VoiceOptions)
  },
  "calendarOptions": {
    object (CalendarOptions)
  },
  "geminiOptions": {
    object (GeminiOptions)
  },
  "geminiInWorkspaceOptions": {
    object (GeminiInWorkspaceOptions)
  }
}
필드
corpus

enum (CorpusType)

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

enum (DataScope)

검색할 데이터 소스입니다.
searchMethod
(deprecated)

enum (SearchMethod)

사용할 검색 메서드입니다.
method

enum (SearchMethod)

검색할 항목입니다. 이 필드는 공유 드라이브를 지원하기 위해 searchMethod를 대체합니다. searchMethod가 TEAM_DRIVE인 경우 이 필드의 응답은 SHARED_DRIVE입니다.
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"입니다.
teamDriveInfo
(deprecated)

object (TeamDriveInfo)

SearchMethod가 TEAM_DRIVE인 경우 필수입니다.
timeZone

string

시간대 이름입니다. 'America/Los_Angeles'와 같은 IANA TZ 이름이어야 합니다. 시간대 이름 목록은 시간대를 참조하세요. Vault에서 시간대를 사용하는 방법에 관한 자세한 내용은 Vault 고객센터를 참고하세요.
필요한 경우 검색할 항목의 세부정보를 지정합니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
accountInfo

object (AccountInfo)

SearchMethod가 ACCOUNT인 경우 필수입니다.
orgUnitInfo

object (OrgUnitInfo)

SearchMethod가 ORG_UNIT인 경우 필수입니다.
sharedDriveInfo

object (SharedDriveInfo)

SearchMethod가 SHARED_DRIVE인 경우 필수입니다.
hangoutsChatInfo

object (HangoutsChatInfo)

SearchMethod가 ROOM인 경우 필수입니다. (읽기 전용)
sitesUrlInfo

object (SitesUrlInfo)

SearchMethod가 SITES_URL인 경우 필수입니다.
driveDocumentInfo

object (DriveDocumentInfo)

SearchMethod가 DRIVE_DOCUMENT인 경우 필수입니다.
상호 배타적인 필드의 끝입니다.
특정 서비스에 대한 추가 검색 옵션입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
mailOptions

object (MailOptions)

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

object (DriveOptions)

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

object (HangoutsChatOptions)

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

object (VoiceOptions)

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

object (CalendarOptions)

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

object (GeminiOptions)

Gemini 앱 검색 관련 옵션을 설정합니다.
geminiInWorkspaceOptions

object (GeminiInWorkspaceOptions)

Workspace의 Gemini 검색 관련 옵션을 설정합니다.
상호 배타적인 필드의 끝입니다.

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에 지정된 공유 드라이브의 파일을 검색합니다.
DRIVE_DOCUMENT DriveDocumentInfo에 지정된 문서를 가져옵니다.

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

DriveDocumentInfo

검색할 Drive 문서입니다.

JSON 표현 
{

  "documentIds": {
    object (DriveDocumentIds)
  }
}
필드
Drive 문서를 검색할 형식입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
documentIds

object (DriveDocumentIds)

문서 ID로 Drive 문서를 지정합니다.
상호 배타적인 필드의 끝입니다.

DriveDocumentIds

문서 ID로 Drive 문서를 지정합니다.

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

string

필수 항목입니다. Drive 문서 ID 목록입니다.

TeamDriveInfo

검색할 팀 드라이브

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

string

Drive API에서 제공하는 팀 드라이브 ID 목록입니다.

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),
  "sharedDrivesOption": enum (SharedDrivesOption)
}
필드
versionDate

string (Timestamp format)

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

생성된 출력은 항상 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"입니다.
includeTeamDrives
(deprecated)

boolean

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

boolean

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

enum (ClientSideEncryptedOption)

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

enum (SharedDrivesOption)

선택사항입니다. 공유 드라이브의 문서를 포함하거나 제외하는 옵션 includeSharedDrives 대신 이 필드를 사용하는 것이 좋습니다. 이 필드는 설정 시 includeSharedDrives 및 includeTeamDrives를 재정의합니다.

SharedDrivesOption

포함할 공유 드라이브 문서 유형에 관한 옵션입니다.

열거형
SHARED_DRIVES_OPTION_UNSPECIFIED 공유 드라이브 옵션이 지정되지 않았습니다.
NOT_INCLUDED 공유 드라이브에 있는 리소스는 검색에 포함되지 않습니다.
INCLUDED_IF_ACCOUNT_IS_NOT_A_MEMBER 공유 드라이브 리소스는 계정이 리소스의 공동작업자이지만 공유 드라이브의 멤버가 아닌 경우에만 포함됩니다. 이는 Vault UI의 '문서가 직접 공유된 경우에만 포함됨 (공유 드라이브 멤버십으로 공유된 항목은 제외)' 옵션에 매핑됩니다. (이전에는 'includeSharedDrives' 사용 중지)
INCLUDED 공유 드라이브의 리소스가 검색에 포함됩니다. (이전의 'includeSharedDrives')

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 better Zealand': 후자만 일치
peopleQuery[]

string

참석자가 지정된 집합의 모든 단어를 포함하는 일정만 일치시킵니다. 집합의 항목은 'and'로 간주됩니다.
minusWords[]

string

제목, 설명, 위치 또는 참석자에 지정된 단어 집합의 단어가 포함되지 않은 일정만 일치시킵니다. 집합의 항목은 'or'로 간주됩니다.
responseStatuses[]

enum (AttendeeResponse)

관리인이 이러한 응답 중 하나를 보낸 일정만 일치합니다. 세트가 비어 있거나 ATTENDEE_RESPONSE_UNSPECIFIED가 포함된 경우 응답에 대한 필터링이 수행되지 않습니다.
versionDate

string (Timestamp format)

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

생성된 출력은 항상 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"입니다.

AttendeeResponse

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

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

GeminiOptions

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

Gemini 앱 검색을 위한 추가 옵션

GeminiInWorkspaceOptions

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

Workspace의 Gemini 검색을 위한 추가 옵션