Query

Definiert eine vom Nutzer eingegebene Anfrage

JSON-Darstellung
{
  "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.
}
Felder
queryId

string

Nur Ausgabe. Eindeutige ID für die Anfrage.

createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Server diese Anfrage akzeptiert hat.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

parts[]

object (QueryPart)

Teile des Anfrageinhalts.

Inhalt der Anfrage. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
text

string

Nur Text

Ende der sich gegenseitig ausschließenden Felder.

QueryPart

Stellt einen Teil oder den gesamten Inhalt dar, der zur Darstellung einer Anfrage verwendet wird. Eine Anfrage kann aus mehreren Teilen bestehen.

JSON-Darstellung
{
  "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.
}
Felder
mimeType

string

Optional. Der IANA-Standard-MIME-Typ der Daten. Siehe https://www.iana.org/assignments/media-types/media-types.xhtml. Dieses Feld ist optional. Wenn nicht festgelegt, wird für das Feld „data“ standardmäßig der MIME-Typ „text/plain“ angenommen.

Die Nutzlast des Anfrageteils. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
text

string

Textinhalt.

uiJsonPayload

string

Dieses Feld muss eine UI-Nachricht im JSON-Format sein. Ab dem ersten Quartal 2026 wird „uiJsonPayload“ nur für A2UI-Nachrichten unterstützt.

personReference

object (PersonReference)

Verweis auf eine Person.

driveDocumentReference

object (DriveDocumentReference)

Verweis auf ein Google Drive-Dokument.

documentReference

object (DocumentReference)

Andere VAIS-Document-Verweise.

Ende der sich gegenseitig ausschließenden Felder.

PersonReference

Stellt einen Personenverweis dar.

JSON-Darstellung
{
  "documentName": string,
  "personId": string,
  "email": string,
  "displayName": string,
  "displayPhotoUri": string,
  "destinationUri": string,
  "fileId": string
}
Felder
documentName

string

Der vollständige Ressourcenname der Person. Format: projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*.

personId

string

Die Personen-ID der Person.

email

string

Die E-Mail-Adresse der Person.

displayName

string

Der Anzeigename der Person.

displayPhotoUri

string

Die URL des Profilfotos der Person.

destinationUri

string

Der Ziel-URI der Person.

fileId

string

Nur Ausgabe. Die Datei-ID der Personendaten, die in den Sitzungskontextdateien gespeichert sind.

DriveDocumentReference

Stellt einen Google Drive-Dokumentverweis dar.

JSON-Darstellung
{
  "driveId": string,
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string
}
Felder
driveId

string

Die Drive-ID des Dokuments.

documentName

string

Der vollständige Ressourcenname des Dokuments. Format: projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*.

displayTitle

string

Der Anzeigename des Verweises.

destinationUri

string

Der Ziel-URI des Verweises.

iconUri

string

Der Symbol-URI des Google Drive-Dokumentverweises.

fileId

string

Nur Ausgabe. Die Datei-ID der Google Drive-Dokumentdaten, die in den Sitzungskontextdateien gespeichert sind.

DocumentReference

Stellt einen Dokumentverweis dar.

JSON-Darstellung
{
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string,
  "urlForConnector": string
}
Felder
documentName

string

Der vollständige Ressourcenname des Dokuments. Format: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}/documents/{documentId}.

displayTitle

string

Der Anzeigename des Verweises.

destinationUri

string

Der Ziel-URI des Verweises.

iconUri

string

Der Symbol-URI des Verweises.

fileId

string

Nur Ausgabe. Die Datei-ID der Dokumentdaten, die in den Sitzungskontextdateien gespeichert sind.

urlForConnector

string

Nur Eingabe. Die urlForConnector des Dokuments, das von der föderierten Suche zurückgegeben wurde.