Query

הגדרת שאילתה שהמשתמש הזין.

ייצוג 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 (Timestamp format)

פלט בלבד. השעה שבה השרת אישר את השאילתה הזו.

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
parts[]

object (QueryPart)

שאילתות לגבי חלקים בתוכן.
שאילתת תוכן. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
text

string

טקסט פשוט.
סוף השדות הבלעדיים.

QueryPart

מייצג חלק מתוכן או את כולו, ומשמש לייצוג שאילתה. שאילתה יכולה לכלול כמה חלקים.

ייצוג 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.
}
שדות
mimeType

string

זה שינוי אופציונלי. סוג ה-MIME של הנתונים לפי תקן IANA. מידע נוסף זמין בכתובת https://www.iana.org/assignments/media-types/media-types.xhtml. השדה הזה הוא אופציונלי. אם לא מגדירים את סוג ה-MIME, ברירת המחדל של סוג ה-MIME בשדה 'נתונים' היא 'text/plain'.
המטען הייעודי (Payload) של חלק השאילתה. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
text

string

תוכן טקסטואלי.
uiJsonPayload

string

השדה הזה אמור להיות הודעת ממשק משתמש בפורמט JSON. נכון לרבעון הראשון של 2026, יש תמיכה ב-uiJsonPayload רק בהודעות A2UI.
personReference

object (PersonReference)

הפניה לאדם.
driveDocumentReference

object (DriveDocumentReference)

הפניה למסמך ב-Google Drive.
documentReference

object (DocumentReference)

הפניות אחרות ל-VAIS Document.
סוף השדות הבלעדיים.

PersonReference

מייצג הפניה לאדם.

ייצוג JSON 
{
  "documentName": string,
  "personId": string,
  "email": string,
  "displayName": string,
  "displayPhotoUri": string,
  "destinationUri": string,
  "fileId": string
}
שדות
documentName

string

השם המלא של המשאב של האדם. פורמט: projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*
personId

string

מזהה האדם.
email

string

כתובת האימייל של האדם.
displayName

string

השם המוצג של האדם.
displayPhotoUri

string

כתובת ה-URL של תמונת הפרופיל של האדם.
destinationUri

string

ה-URI של היעד של האדם.
fileId

string

פלט בלבד. מזהה הקובץ של נתוני האדם שמאוחסנים בקובצי ההקשר של הסשן.

DriveDocumentReference

מייצג הפניה למסמך Google Drive.

ייצוג JSON 
{
  "driveId": string,
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string
}
שדות
driveId

string

מזהה Drive של המסמך.
documentName

string

השם המלא של המשאב של המסמך. פורמט: projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/*
displayTitle

string

השם המוצג של קובץ העזר.
destinationUri

string

ה-URI של היעד של ההפניה.
iconUri

string

ה-URI של סמל ההפניה למסמך ב-Drive.
fileId

string

פלט בלבד. מזהה הקובץ של נתוני מסמך Drive שמאוחסנים בקבצי ההקשר של הסשן.

DocumentReference

מייצג הפניה למסמך.

ייצוג JSON 
{
  "documentName": string,
  "displayTitle": string,
  "destinationUri": string,
  "iconUri": string,
  "fileId": string,
  "urlForConnector": string
}
שדות
documentName

string

השם המלא של המשאב של המסמך. פורמט: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}/documents/{documentId}
displayTitle

string

השם המוצג של קובץ העזר.
destinationUri

string

ה-URI של היעד של ההפניה.
iconUri

string

ה-URI של הסמל של ההפניה.
fileId

string

פלט בלבד. מזהה הקובץ של נתוני המסמך שמאוחסנים בקבצים של הקשר הסשן.
urlForConnector

string

קלט בלבד. כתובת ה-URL של המחבר של המסמך שהוחזרה על ידי החיפוש המאוחד.