Query

사용자가 입력한 쿼리를 정의합니다.

JSON 표현 
{
  "queryId": string,
  "createTime": string,
  "parts": [
    {
      object (QueryPart)
    }
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "text": string
  // End of mutually exclusive fields.
}
필드
queryId

string

출력 전용입니다. 쿼리의 고유 ID입니다.
createTime

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

object (QueryPart)

쿼리 콘텐츠 부분입니다.
콘텐츠를 쿼리합니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 필드가 최대 하나 설정됩니다.
text

string

일반 텍스트
상호 배타적인 필드의 끝입니다.

QueryPart

쿼리를 나타내는 데 사용되는 콘텐츠의 일부 또는 전체를 나타냅니다. 쿼리는 여러 부분으로 구성될 수 있습니다.

JSON 표현 
{
  "mimeType": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "text": string,
  "uiJsonPayload": string,
  "personReference": {
    object (PersonReference)
  },
  "driveDocumentReference": {
    object (DriveDocumentReference)
  },
  "documentReference": {
    object (DocumentReference)
  }
  // End of mutually exclusive fields.
}
필드
mimeType

string

선택사항입니다. 데이터의 IANA 표준 MIME 유형입니다. https://www.iana.org/assignments/media-types/media-types.xhtml에서 확인하세요. 이 필드는 선택사항입니다. 설정되지 않은 경우 'data' 필드의 기본 MIME 유형은 'text/plain'으로 가정됩니다.
쿼리 부분의 페이로드입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 필드가 최대 하나 설정됩니다.
text

string

텍스트 콘텐츠입니다.
uiJsonPayload

string

이 필드는 JSON 형식의 UI 메시지여야 합니다. 2026년 1분기부터 uiJsonPayload는 A2UI 메시지만 지원합니다.
personReference

object (PersonReference)

사용자 참조
driveDocumentReference

object (DriveDocumentReference)

Google Drive 문서 참조
documentReference

object (DocumentReference)

기타 VAIS Document 참조
상호 배타적인 필드의 끝입니다.

PersonReference

사용자 참조를 나타냅니다.

JSON 표현 
{
  "documentName": string,
  "personId": string,
  "email": string,
  "displayName": string,
  "displayPhotoUri": string,
  "destinationUri": string,
  "fileId": string
}
필드
documentName

string

사용자의 전체 리소스 이름입니다. 형식은 projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*입니다.
personId

string

사용자의 사용자 ID입니다.
email

string

사용자의 이메일입니다.
displayName

string

사용자의 표시 이름입니다.
displayPhotoUri

string

사용자의 표시 사진 URL입니다.
destinationUri

string

사용자의 대상 URI입니다.
fileId

string

출력 전용입니다. 세션 컨텍스트 파일에 저장된 사용자 데이터의 파일 ID입니다.

DriveDocumentReference

Google Drive 문서 참조를 나타냅니다.

JSON 표현 
{
  "driveId": string,
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string
}
필드
driveId

string

문서의 Drive ID입니다.
documentName

string

문서의 전체 리소스 이름입니다. 형식은 projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*입니다.
displayTitle

string

참조의 표시 제목입니다.
destinationUri

string

참조의 대상 URI입니다.
iconUri

string

Drive 문서 참조의 아이콘 URI입니다.
fileId

string

출력 전용입니다. 세션 컨텍스트 파일에 저장된 Drive 문서 데이터의 파일 ID입니다.

DocumentReference

문서 참조를 나타냅니다.

JSON 표현 
{
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string,
  "urlForConnector": string
}
필드
documentName

string

문서의 전체 리소스 이름입니다. 형식은 projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}/documents/{documentId}입니다.
displayTitle

string

참조의 표시 제목입니다.
destinationUri

string

참조의 대상 URI입니다.
iconUri

string

참조의 아이콘 URI입니다.
fileId

string

출력 전용입니다. 세션 컨텍스트 파일에 저장된 문서 데이터의 파일 ID입니다.
urlForConnector

string

입력 전용입니다. 제휴 검색에서 반환된 문서의 urlForConnector입니다.