Query

• JSON 表示法
• QueryPart
  • JSON 表示法
• PersonReference
  • JSON 表示法
• DriveDocumentReference
  • JSON 表示法
• DocumentReference
  • JSON 表示法

定义用户输入的查询。

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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 格式的界面消息。截至 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 人员的目标网址。
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 引用的目标网址。
iconUri	string 云端硬盘文档引用的图标网址。
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 引用的目标网址。
iconUri	string 引用的图标网址。
fileId	string 仅限输出。存储在会话上下文文件中的文档数据的文件 ID。
urlForConnector	string 仅限输入。联合搜索返回的文档的 urlForConnector。