Query

Define una consulta ingresada por el usuario.

Representación 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.
}
Campos
queryId

string

Solo salida. Es el ID único de la consulta.
createTime

string (Timestamp format)

Solo salida. Es la hora en la que el servidor aceptó esta consulta.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
parts[]

object (QueryPart)

Son las partes del contenido de la consulta.
Contenido de la consulta. A continuación, se incluye una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
text

string

Texto sin formato
Fin de los campos mutuamente excluyentes.

QueryPart

Representa una parte o la totalidad de un contenido, que se usa para representar una consulta. Una consulta puede constar de varias partes.

Representación 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.
}
Campos
mimeType

string

Es opcional. Es el tipo de MIME estándar de IANA de los datos. Consulta https://www.iana.org/assignments/media-types/media-types.xhtml. Este campo es opcional. Si no se establece, el tipo de MIME predeterminado es "text/plain" para el campo "data".
Es la carga útil de la parte de la consulta. A continuación, se incluye una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
text

string

Contenido de texto.
uiJsonPayload

string

Se espera que este campo sea un mensaje de IU en formato JSON. A partir del primer trimestre de 2026, uiJsonPayload solo será compatible con los mensajes de A2UI.
personReference

object (PersonReference)

Referencia a una persona.
driveDocumentReference

object (DriveDocumentReference)

Referencia a un documento de Google Drive.
documentReference

object (DocumentReference)

Otras referencias de Document de VAIS.
Fin de los campos mutuamente excluyentes.

PersonReference

Representa una referencia de persona.

Representación JSON 
{
  "documentName": string,
  "personId": string,
  "email": string,
  "displayName": string,
  "displayPhotoUri": string,
  "destinationUri": string,
  "fileId": string
}
Campos
documentName

string

Es el nombre completo del recurso de la persona. Formato: projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*.
personId

string

Es el ID de la persona.
email

string

Es el correo electrónico de la persona.
displayName

string

Es el nombre visible de la persona.
displayPhotoUri

string

Es la URL de la foto de perfil de la persona.
destinationUri

string

Es la URI de destino de la persona.
fileId

string

Solo salida. Es el ID del archivo de los datos de la persona almacenados en los archivos de contexto de la sesión.

DriveDocumentReference

Representa una referencia de documento de Google Drive.

Representación JSON 
{
  "driveId": string,
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string
}
Campos
driveId

string

Es el ID de Drive del documento.
documentName

string

Es el nombre completo del recurso del documento. Formato: projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*.
displayTitle

string

Es el título visible de la referencia.
destinationUri

string

Es la URI de destino de la referencia.
iconUri

string

Es la URI del ícono de la referencia del documento de Drive.
fileId

string

Solo salida. Es el ID del archivo de los datos del documento de Drive almacenados en los archivos de contexto de la sesión.

DocumentReference

Representa una referencia de documento.

Representación JSON 
{
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string,
  "urlForConnector": string
}
Campos
documentName

string

Es el nombre completo del recurso del documento. Formato: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}/documents/{documentId}.
displayTitle

string

Es el título visible de la referencia.
destinationUri

string

Es la URI de destino de la referencia.
iconUri

string

Es la URI del ícono de la referencia.
fileId

string

Solo salida. Es el ID del archivo de los datos del documento almacenados en los archivos de contexto de la sesión.
urlForConnector

string

Solo entrada. Es la urlForConnector del documento que muestra la Búsqueda federada.