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)

僅供輸出。伺服器接受這項查詢的時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「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 雲端硬碟文件。
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

使用者的顯示相片網址。
destinationUri

string

對方的目的地 URI。
fileId

string

僅供輸出。儲存在工作階段內容檔案中的個人資料檔案 ID。

DriveDocumentReference

代表 Google 雲端硬碟文件參照。

JSON 表示法 
{
  "driveId": string,
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string
}
欄位
driveId

string

文件的雲端硬碟 ID。
documentName

string

文件的完整資源名稱。格式：projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*。
displayTitle

string

參考資料的顯示標題。
destinationUri

string

參照的目標 URI。
iconUri

string

雲端硬碟文件參照的圖示 URI。
fileId

string

僅供輸出。儲存在工作階段內容檔案中的雲端硬碟文件資料檔案 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。