SearchResponse

הודעת תגובה לשיטה SearchService.Search.

ייצוג JSON 
{
  "results": [
    {
      object (SearchResult)
    }
  ],
  "facets": [
    {
      object (Facet)
    }
  ],
  "totalSize": integer,
  "attributionToken": string,
  "redirectUri": string,
  "nextPageToken": string,
  "correctedQuery": string,
  "summary": {
    object (Summary)
  },
  "appliedControls": [
    string
  ],
  "queryExpansionInfo": {
    object (QueryExpansionInfo)
  },
  "naturalLanguageQueryUnderstandingInfo": {
    object (NaturalLanguageQueryUnderstandingInfo)
  },
  "sessionInfo": {
    object (SessionInfo)
  },
  "searchLinkPromotions": [
    {
      object (SearchLinkPromotion)
    }
  ],
  "semanticState": enum (SemanticState)
}
שדות
results[]

object (SearchResult)

רשימה של מסמכים תואמים. הסדר מייצג את הדירוג.
facets[]

object (Facet)

תוצאות של היבטים שהמשתמש ביקש.
totalSize

integer

המספר הכולל המשוער של פריטים שתואמים לשאילתה, ללא קשר להחלוקה לדפים. יכול להיות שמספר התוצאות results שמוחזרות על ידי חלוקה לעמודים יהיה קטן ממספר התוצאות totalSize שתואמות.
attributionToken

string

טוקן חיפוש ייחודי. הפרמטר הזה צריך להיכלל ביומני UserEvent שנוצרים כתוצאה מהחיפוש הזה, כדי לאפשר שיוך מדויק של ביצועי מודל החיפוש. המידע הזה גם עוזר לזהות בקשה בתרחישים של תמיכת לקוחות.
redirectUri

string

ה-URI של דף הפניה שהוגדר על ידי הלקוח. אם מופעלת פעולת הפניה אוטומטית, לא מתבצע חיפוש ורק הערכים redirectUri ו-attributionToken מוגדרים בתגובה.
nextPageToken

string

טוקן שאפשר לשלוח כ-SearchRequest.page_token כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.
correctedQuery

string

מכיל את השאילתה עם תיקון האיות, אם נמצאה. אם סוג תיקון האיות הוא AUTOMATIC, תוצאות החיפוש מבוססות על correctedQuery. אחרת, נעשה שימוש בשאילתה המקורית לחיפוש.
summary

object (Summary)

סיכום כחלק מתוצאות החיפוש. השדה הזה מוחזר רק אם מוגדר הערך SearchRequest.ContentSearchSpec.summary_spec.
appliedControls[]

string

זה שינוי אופציונלי. אמצעי הבקרה שמוחלים כחלק משירות הבקרה.
queryExpansionInfo

object (QueryExpansionInfo)

מידע על הרחבת השאילתה עבור התוצאות שהוחזרו.
naturalLanguageQueryUnderstandingInfo

object (NaturalLanguageQueryUnderstandingInfo)

פלט בלבד. מידע על הבנת שאילתות בשפה טבעית לגבי התוצאות שהוחזרו.
sessionInfo

object (SessionInfo)

פרטי הסשן.

המאפיין הזה מוגדר רק אם מציינים את SearchRequest.session. פרטים נוספים מופיעים בתיאור.
semanticState

enum (SemanticState)

פלט בלבד. מציין את המצב הסמנטי של תשובת החיפוש.

מאפיין

תוצאה של מאפיין.

ייצוג JSON 
{
  "key": string,
  "values": [
    {
      object (FacetValue)
    }
  ],
  "dynamicFacet": boolean
}
שדות
key

string

המפתח של ההיבט הזה. לדוגמה, "colors" או "price". היא תואמת ל-SearchRequest.FacetSpec.FacetKey.key.
values[]

object (FacetValue)

ערכי הפנים של השדה הזה.
dynamicFacet

boolean

האם ההיבט נוצר באופן דינמי.

FacetValue

ערך של היבט שמכיל שמות של ערכים ואת הספירה שלהם.

ייצוג JSON 
{
  "count": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "value": string,
  "interval": {
    object (Interval)
  }
  // End of mutually exclusive fields.
}
שדות
count

string (int64 format)

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

string

ערך טקסט של היבט, כמו 'שחור' עבור ההיבט 'צבעים'.
interval

object (Interval)

ערך המרווח של היבט, למשל [10, 20) עבור היבט 'מחיר'. היא תואמת ל-SearchRequest.FacetSpec.FacetKey.intervals.
סוף השדות הבלעדיים.

QueryExpansionInfo

מידע שמתאר את הרחבת השאילתה, כולל אם ההרחבה התרחשה.

ייצוג JSON 
{
  "expandedQuery": boolean,
  "pinnedResultCount": string
}
שדות
expandedQuery

boolean

ערך בוליאני שמתאר אם בוצעה הרחבת שאילתה.
pinnedResultCount

string (int64 format)

מספר התוצאות המוצמדות. השדה הזה יוגדר רק כשההרחבה מתבצעת והשדה SearchRequest.QueryExpansionSpec.pin_unexpanded_results מוגדר כ-true.

NaturalLanguageQueryUnderstandingInfo

מידע שמתאר את הבנת השפה הטבעית שבוצעה בשאילתת הקלט.

ייצוג JSON 
{
  "extractedFilters": string,
  "rewrittenQuery": string,
  "classifiedIntents": [
    string
  ],
  "structuredExtractedFilter": {
    object (StructuredExtractedFilter)
  }
}
שדות
extractedFilters

string

המסננים שחולצו משאילתת הקלט.
rewrittenQuery

string

השאילתה שנכתבה מחדש ללא המסננים שחולצו.
classifiedIntents[]

string

הכוונות שסווגו מתוך שאילתת הקלט.
structuredExtractedFilter

object (StructuredExtractedFilter)

המסננים שחולצו משאילתת הקלט, שמוצגים בצורה מובנית.

StructuredExtractedFilter

המסננים שחולצו משאילתת הקלט, שמוצגים בצורה מובנית.

ייצוג JSON 
{
  "expression": {
    object (Expression)
  }
}
שדות
expression

object (Expression)

הביטוי המציין את המסנן שחולץ משאילתת הקלט בצורה מובנית. הוא יכול להיות ביטוי פשוט שמציין אילוץ יחיד של מחרוזת, מספר או מיקום גיאוגרפי, או ביטוי מורכב שהוא שילוב של כמה ביטויים שמחוברים באמצעות אופרטורים לוגיים (OR ו-AND).

ביטוי

הביטוי שמציין את המסנן שחולץ משאילתת הקלט.

ייצוג JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringConstraint": {
    object (StringConstraint)
  },
  "numberConstraint": {
    object (NumberConstraint)
  },
  "geolocationConstraint": {
    object (GeolocationConstraint)
  },
  "andExpr": {
    object (AndExpression)
  },
  "orExpr": {
    object (OrExpression)
  }
  // End of mutually exclusive fields.
}
שדות
סוג הביטוי. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
stringConstraint

object (StringConstraint)

ביטוי של אילוץ מחרוזת.
numberConstraint

object (NumberConstraint)

ביטוי של אילוץ מספרי.
geolocationConstraint

object (GeolocationConstraint)

ביטוי של מגבלת מיקום גיאוגרפי.
andExpr

object (AndExpression)

אופרטור מורכב לוגי And שמקשר בין כמה ביטויים.
orExpr

object (OrExpression)

אופרטור מורכב לוגי 'או' שמקשר בין כמה ביטויים.
סוף השדות הבלעדיים.

StringConstraint

ביטוי אילוץ של שדה מחרוזת.

ייצוג JSON 
{
  "fieldName": string,
  "values": [
    string
  ],
  "querySegment": string
}
שדות
fieldName

string

השם של שדה המחרוזת כפי שהוא מוגדר בסכימה.
values[]

string

הערכים של שדה המחרוזת. הרשומה תוחזר רק אם ערך השדה תואם לאחד מהערכים שצוינו כאן.
querySegment

string

מזהה את מילות המפתח בשאילתת החיפוש שתואמות למסנן.

NumberConstraint

ביטוי אילוץ של שדה מספר. דוגמה: price < 100.

ייצוג JSON 
{
  "fieldName": string,
  "comparison": enum (Comparison),
  "value": number,
  "querySegment": string
}
שדות
fieldName

string

השם של השדה המספרי כפי שהוא מוגדר בסכימה.
comparison

enum (Comparison)

פעולת ההשוואה שמתבצעת בין ערך השדה לבין הערך שצוין באילוץ.
value

number

הערך שצוין באילוץ המספרי.
querySegment

string

מזהה את מילות המפתח בשאילתת החיפוש שתואמות למסנן.

השוואה

פעולת ההשוואה שבוצעה.

טיפוסים בני מנייה (enum)
COMPARISON_UNSPECIFIED אופרטור השוואה לא מוגדר.
EQUALS מציין את האופרטור = שבודק שוויון.
LESS_THAN_EQUALS מציין את האופרטור 'קטן מ- או שווה ל-' <=.
LESS_THAN מציין פחות מ-<.
GREATER_THAN_EQUALS מציין את האופרטור 'גדול מ- או שווה ל-' >=.
GREATER_THAN מציין את האופרטור 'גדול מ-' >.

GeolocationConstraint

מגבלה של שדה מיקום גיאוגרפי. השם של שדה המיקום הגיאוגרפי כפי שהוגדר בסכימה.

ייצוג JSON 
{
  "fieldName": string,
  "address": string,
  "latitude": number,
  "longitude": number,
  "radiusInMeters": number
}
שדות
fieldName

string

השם של שדה המיקום הגיאוגרפי כפי שהוגדר בסכימה.
address

string

כתובת ההפניה שהוסבה משאילתת הקלט. הקרבה של כתובת ההפניה לשדה המיקום הגיאוגרפי תשמש לסינון התוצאות.
latitude

number

קו הרוחב של המיקום הגיאוגרפי כפי שנסק משאילתת הקלט.
longitude

number

קו האורך של המיקום הגיאוגרפי שנאסף משאילתת הקלט.
radiusInMeters

number

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

AndExpression

אופרטור לוגי And.

ייצוג JSON 
{
  "expressions": [
    {
      object (Expression)
    }
  ]
}
שדות
expressions[]

object (Expression)

הביטויים שעברו AND יחד.

OrExpression

אופרטור לוגי Or.

ייצוג JSON 
{
  "expressions": [
    {
      object (Expression)
    }
  ]
}
שדות
expressions[]

object (Expression)

הביטויים שעברו OR יחד.

SessionInfo

מידע על המושב.

ייצוג JSON 
{
  "name": string,
  "queryId": string
}
שדות
name

string

שם המושב. אם נעשה שימוש במצב סשן אוטומטי (כאשר SearchRequest.session מסתיים ב-"-"), שדה זה מכיל את שם הסשן החדש שנוצר.
queryId

string

מזהה שאילתה התואם לקריאה זו של API החיפוש. בסשן אחד יכולים להיות כמה תורות, שלכל אחת מהן יש מזהה שאילתה ייחודי.

על ידי ציון שם הסשן ומזהה השאילתה הזה בקריאה ל-Answer API, יצירת התשובה מתרחשת בהקשר של תוצאות החיפוש מקריאה זו.

SemanticState

מצב סמנטי של התגובה לחיפוש.

טיפוסים בני מנייה (enum)
SEMANTIC_STATE_UNSPECIFIED ערך ברירת המחדל. אין להשתמש בו.
DISABLED החיפוש הסמנטי הושבת בתגובה הזו לחיפוש.
ENABLED החיפוש הסמנטי הופעל בתשובה הזו לחיפוש.