Query

Définit une requête saisie par l'utilisateur.

Représentation 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.
}
Champs
queryId

string

Uniquement en sortie. ID unique de la requête.

createTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle le serveur a accepté cette requête.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

parts[]

object (QueryPart)

Parties du contenu de la requête.

Contenu de la requête. Voici une liste de champs mutuellement exclusifs. Au maximum, un seul de ces champs sera défini dans une réponse :
text

string

Texte brut.

Fin des champs mutuellement exclusifs.

QueryPart

Représente une partie ou l'intégralité d'un contenu, utilisé pour représenter une requête. Une requête peut être composée de plusieurs parties.

Représentation 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.
}
Champs
mimeType

string

Facultatif. Type MIME standard IANA des données. Consultez https://www.iana.org/assignments/media-types/media-types.xhtml. Ce champ est facultatif. S'il n'est pas défini, le type MIME par défaut est "text/plain" pour le champ "data".

Charge utile de la partie de la requête. Voici une liste de champs mutuellement exclusifs. Au maximum, un seul de ces champs sera défini dans une réponse :
text

string

Contenu textuel.

uiJsonPayload

string

Ce champ doit être un message d'interface utilisateur au format JSON. Depuis le premier trimestre 2026, uiJsonPayload n'est compatible qu'avec les messages A2UI.

personReference

object (PersonReference)

Référence à une personne.

driveDocumentReference

object (DriveDocumentReference)

Référence à un document Google Drive.

documentReference

object (DocumentReference)

Autres références Document VAIS.

Fin des champs mutuellement exclusifs.

PersonReference

Représente une référence à une personne.

Représentation JSON
{
  "documentName": string,
  "personId": string,
  "email": string,
  "displayName": string,
  "displayPhotoUri": string,
  "destinationUri": string,
  "fileId": string
}
Champs
documentName

string

Nom complet de la ressource de la personne. Format: projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*.

personId

string

ID de la personne.

email

string

Adresse e-mail de la personne.

displayName

string

Nom à afficher de la personne.

displayPhotoUri

string

URL de la photo de profil de la personne.

destinationUri

string

URI de destination de la personne.

fileId

string

Uniquement en sortie. ID du fichier des données de la personne stockées dans les fichiers de contexte de session.

DriveDocumentReference

Représente une référence à un document Google Drive.

Représentation JSON
{
  "driveId": string,
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string
}
Champs
driveId

string

ID Drive du document.

documentName

string

Nom complet de la ressource du document. Format: projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*.

displayTitle

string

Titre à afficher de la référence.

destinationUri

string

URI de destination de la référence.

iconUri

string

URI de l'icône de la référence au document Drive.

fileId

string

Uniquement en sortie. ID du fichier des données du document Drive stockées dans les fichiers de contexte de session.

DocumentReference

Représente une référence à un document.

Représentation JSON
{
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string,
  "urlForConnector": string
}
Champs
documentName

string

Nom complet de la ressource du document. Format: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}/documents/{documentId}.

displayTitle

string

Titre à afficher de la référence.

destinationUri

string

URI de destination de la référence.

iconUri

string

URI de l'icône de la référence.

fileId

string

Uniquement en sortie. ID du fichier des données du document stockées dans les fichiers de contexte de session.

urlForConnector

string

Uniquement en entrée. URL du connecteur du document renvoyé par la recherche fédérée.