Query

Definisce una query inserita dall'utente.

Rappresentazione 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.
}
Campi
queryId

string

Solo output. ID univoco della query.
createTime

string (Timestamp format)

Solo output. L'ora in cui il server ha accettato questa query.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
parts[]

object (QueryPart)

Parti dei contenuti della query.
Contenuti della query. Di seguito è riportato un elenco di campi che si escludono a vicenda. Al massimo uno dei campi verrà impostato in una risposta:
text

string

Testo normale.
Fine dei campi che si escludono a vicenda.

QueryPart

Rappresenta una parte o l'intero contenuto, utilizzato per rappresentare una query. Una query può essere composta da più parti.

Rappresentazione 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.
}
Campi
mimeType

string

Facoltativo. Il tipo MIME standard IANA dei dati. Vedi https://www.iana.org/assignments/media-types/media-types.xhtml. Questo campo è facoltativo. Se non è impostato, il tipo MIME predefinito è "text/plain" per il campo "data".
Il payload della parte della query. Di seguito è riportato un elenco di campi che si escludono a vicenda. Al massimo uno dei campi verrà impostato in una risposta:
text

string

Contenuto testuale.
uiJsonPayload

string

Questo campo deve essere un messaggio dell'interfaccia utente in formato JSON. A partire dal primo trimestre del 2026, uiJsonPayload è supportato solo per i messaggi A2UI.
personReference

object (PersonReference)

Riferimento a una persona.
driveDocumentReference

object (DriveDocumentReference)

Riferimento a un documento di Google Drive.
documentReference

object (DocumentReference)

Altri riferimenti Document VAIS.
Fine dei campi che si escludono a vicenda.

PersonReference

Rappresenta un riferimento a una persona.

Rappresentazione JSON 
{
  "documentName": string,
  "personId": string,
  "email": string,
  "displayName": string,
  "displayPhotoUri": string,
  "destinationUri": string,
  "fileId": string
}
Campi
documentName

string

Il nome completo della risorsa della persona. Formato: projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*.
personId

string

L'ID persona della persona.
email

string

L'indirizzo email della persona.
displayName

string

Il nome visualizzato della persona.
displayPhotoUri

string

L'URL della foto del profilo della persona.
destinationUri

string

L'URI di destinazione della persona.
fileId

string

Solo output. L'ID file dei dati della persona archiviati nei file di contesto della sessione.

DriveDocumentReference

Rappresenta un riferimento a un documento di Google Drive.

Rappresentazione JSON 
{
  "driveId": string,
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string
}
Campi
driveId

string

L'ID Drive del documento.
documentName

string

Il nome completo della risorsa del documento. Formato: projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*.
displayTitle

string

Il titolo visualizzato del riferimento.
destinationUri

string

L'URI di destinazione del riferimento.
iconUri

string

L'URI dell'icona del riferimento al documento di Drive.
fileId

string

Solo output. L'ID file dei dati del documento di Drive archiviati nei file di contesto della sessione.

DocumentReference

Rappresenta un riferimento a un documento.

Rappresentazione JSON 
{
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string,
  "urlForConnector": string
}
Campi
documentName

string

Il nome completo della risorsa del documento. Formato: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}/documents/{documentId}.
displayTitle

string

Il titolo visualizzato del riferimento.
destinationUri

string

L'URI di destinazione del riferimento.
iconUri

string

L'URI dell'icona del riferimento.
fileId

string

Solo output. L'ID file dei dati del documento archiviati nei file di contesto della sessione.
urlForConnector

string

Solo input. L'urlForConnector del documento restituito da Ricerca federata.