Query

Define uma consulta inserida pelo usuário.

Representação 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

Apenas saída. ID exclusivo da consulta.

createTime

string (Timestamp format)

Apenas saída. O horário em que o servidor aceitou essa consulta.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

parts[]

object (QueryPart)

Partes do conteúdo da consulta.

Conteúdo da consulta. A seguir, há uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
text

string

Texto simples.

Fim dos campos mutuamente exclusivos.

QueryPart

Representa uma parte ou a totalidade de um conteúdo, usado para representar uma consulta. Uma consulta pode ser composta de várias partes.

Representação 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

Opcional. O tipo MIME padrão da IANA dos dados. Consulte https://www.iana.org/assignments/media-types/media-types.xhtml. Este campo é opcional. Se não for definido, o tipo MIME padrão presumido será "text/plain" para o campo "data".

O payload da parte da consulta. A seguir, há uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
text

string

Conteúdo de texto.

uiJsonPayload

string

Espera-se que esse campo seja uma mensagem de interface em formato JSON. A partir do primeiro trimestre de 2026, uiJsonPayload só será compatível com mensagens A2UI.

personReference

object (PersonReference)

Referência a uma pessoa.

driveDocumentReference

object (DriveDocumentReference)

Referência a um documento do Google Drive.

documentReference

object (DocumentReference)

Outras referências de Document do VAIS.

Fim dos campos mutuamente exclusivos.

PersonReference

Representa uma referência de pessoa.

Representação JSON
{
  "documentName": string,
  "personId": string,
  "email": string,
  "displayName": string,
  "displayPhotoUri": string,
  "destinationUri": string,
  "fileId": string
}
Campos
documentName

string

O nome completo do recurso da pessoa. Formato: projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*.

personId

string

O ID da pessoa.

email

string

O e-mail da pessoa.

displayName

string

O nome de exibição da pessoa.

displayPhotoUri

string

O URL da foto de exibição da pessoa.

destinationUri

string

O URI de destino da pessoa.

fileId

string

Apenas saída. O ID do arquivo dos dados da pessoa armazenados nos arquivos de contexto da sessão.

DriveDocumentReference

Representa uma referência de documento do Google Drive.

Representação JSON
{
  "driveId": string,
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string
}
Campos
driveId

string

O ID do Drive do documento.

documentName

string

O nome completo do recurso do documento. Formato: projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*.

displayTitle

string

O título de exibição da referência.

destinationUri

string

O URI de destino da referência.

iconUri

string

O URI do ícone da referência do documento do Drive.

fileId

string

Apenas saída. O ID do arquivo dos dados do documento do Drive armazenados nos arquivos de contexto da sessão.

DocumentReference

Representa uma referência de documento.

Representação JSON
{
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string,
  "urlForConnector": string
}
Campos
documentName

string

O nome completo do recurso do documento. Formato: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}/documents/{documentId}.

displayTitle

string

O título de exibição da referência.

destinationUri

string

O URI de destino da referência.

iconUri

string

O URI do ícone da referência.

fileId

string

Apenas saída. O ID do arquivo dos dados do documento armazenados nos arquivos de contexto da sessão.

urlForConnector

string

Somente entrada. O urlForConnector do documento retornado pela pesquisa federada.