Nota: Este conjunto de documentación es para las ediciones Standard, Plus, de pago por uso y Frontline de Gemini Enterprise. Para obtener la documentación de la edición Business, consulta el Centro de ayuda de Gemini Enterprise Business.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Query

Representación JSON
QueryPart
- Representación JSON
PersonReference
- Representación JSON
DriveDocumentReference
- Representación JSON
DocumentReference
- Representación JSON
UserSuppliedSobiArtifactReference
- Representación JSON

Define una búsqueda ingresada por el usuario.

Representación JSON

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. }

{
  "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 búsqueda.
`createTime`	`string (Timestamp format)` Solo salida. Es la fecha y hora en la que el servidor aceptó esta búsqueda. 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)` Consultar partes del contenido
Contenido de la búsqueda La siguiente es 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 y se usa para representar una búsqueda. Una búsqueda puede constar de varias partes.

Representación JSON

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`) }, "userSuppliedSobiArtifactReference": { object (`UserSuppliedSobiArtifactReference`) } // End of mutually exclusive fields. }

{
  "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)
  },
  "userSuppliedSobiArtifactReference": {
    object (UserSuppliedSobiArtifactReference)
  }
  // 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 configura, el tipo de MIME predeterminado que se supone es "text/plain" para el campo "data".
Es la carga útil de la parte de la consulta. La siguiente es 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 la IU en formato JSON. A partir del primer trimestre de 2026, uiJsonPayload solo se admitirá para los mensajes de A2UI.
`personReference`	`object (PersonReference)` Es una referencia a una persona.
`driveDocumentReference`	`object (DriveDocumentReference)` Es una referencia a un documento de Google Drive.
`documentReference`	`object (DocumentReference)` Otras referencias de VAIS `Document`.
`userSuppliedSobiArtifactReference`	`object (UserSuppliedSobiArtifactReference)` Es una referencia a un archivo proporcionado por el usuario que se adjunta a una tarea de agente de ejecución prolongada (Sobi). Consulta `UserSuppliedSobiArtifactReference` más arriba.
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 el 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 a un 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 el URI de destino de la referencia.
`iconUri`	`string` Es el 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 el URI de destino de la referencia.
`iconUri`	`string` Es el 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 URL del conector (urlForConnector) del documento que devolvió la búsqueda federada.

UserSuppliedSobiArtifactReference

Es una referencia a un archivo proporcionado por el usuario que se adjunta a una tarea de agente de ejecución prolongada (Sobi). El cliente lo renderiza como un chip de adjunto en la burbuja del turno del usuario. El archivo en sí se almacena en la lista AgentArtifact de la tarea. El cliente resuelve los metadatos completos (URI de origen, tamaño, etc.) para la descarga o la vista previa llamando a tasks.get en la API de Sobi Task y haciendo coincidir AgentArtifact.name con fileName.

Solo aparecen fileName y mimeType en este esquema a propósito: el URI de respaldo gs:// o de Drive no se expone a los lectores del historial de conversaciones. Se usa la misma variante para los archivos subidos por bytes y los seleccionados en Drive: "El usuario adjuntó un archivo" es un concepto, independientemente de la fuente.

Representación JSON
{ "fileName": string, "mimeType": string }

Campos

Campos
`fileName`	`string` Obligatorio. Es el nombre de archivo proporcionado por el cliente. Es único por tarea dentro del conjunto de artefactos proporcionado por el usuario (la IU elimina los duplicados antes de la carga). También funciona como identificador del artefacto que se usa para buscarlo en `Task.artifacts`. El sufijo `_name` es intencional y se suprime la verificación de AIP-122: este campo no es un nombre de recurso (que es para lo que AIP-122 reserva el `name` sin formato). Es el nombre de archivo literal y sirve como clave de unión con `AgentArtifact.name` en la tarea de respaldo de Sobi, un rol estructural que `title` o `displayName` no comunicarían a un cliente que elige qué enviar. El duplicado interno (`cloud/ml/discoveryengine/schema/assistant.proto`) usa el mismo nombre de campo, por lo que el convertidor de ida y vuelta conserva el nombre.
`mimeType`	`string` Es opcional. Tipo de MIME de IANA. Se usa para la renderización de íconos y vistas previas.

fileName

string

Obligatorio. Es el nombre de archivo proporcionado por el cliente. Es único por tarea dentro del conjunto de artefactos proporcionado por el usuario (la IU elimina los duplicados antes de la carga). También funciona como identificador del artefacto que se usa para buscarlo en Task.artifacts.

El sufijo _name es intencional y se suprime la verificación de AIP-122: este campo no es un nombre de recurso (que es para lo que AIP-122 reserva el name sin formato). Es el nombre de archivo literal y sirve como clave de unión con AgentArtifact.name en la tarea de respaldo de Sobi, un rol estructural que title o displayName no comunicarían a un cliente que elige qué enviar. El duplicado interno (cloud/ml/discoveryengine/schema/assistant.proto) usa el mismo nombre de campo, por lo que el convertidor de ida y vuelta conserva el nombre.

mimeType