SearchResponse

התשובה של Search API. מזהה NEXT: ‏ 17

ייצוג ב-JSON 
{
  "queryInterpretation": {
    object (QueryInterpretation)
  },
  "results": [
    {
      object (SearchResult)
    }
  ],
  "structuredResults": [
    {
      object (StructuredResult)
    }
  ],
  "spellResults": [
    {
      object (SpellResult)
    }
  ],
  "facetResults": [
    {
      object (FacetResult)
    }
  ],
  "hasMoreResults": boolean,
  "debugInfo": {
    object (ResponseDebugInfo)
  },
  "errorInfo": {
    object (ErrorInfo)
  },
  "resultCounts": {
    object (ResultCounts)
  },

  // Union field result_count can be only one of the following:
  "resultCountEstimate": string,
  "resultCountExact": string
  // End of list of possible types for union field result_count.
}
שדות
queryInterpretation

object (QueryInterpretation)

תוצאת הפרשנות של שאילתת המשתמש. השדה נשאר ריק אם הפרשנות של השאילתות מושבתת.
results[]

object (SearchResult)

תוצאות משאילתת חיפוש.
structuredResults[]

object (StructuredResult)

תוצאות מובנות לשאילתת המשתמש. התוצאות האלה לא נספרות במסגרת pageSize.
spellResults[]

object (SpellResult)

הצעת איות לשאילתה.
facetResults[]

object (FacetResult)

תוצאות של מאפיינים חוזרים.
hasMoreResults

boolean

אם יש תוצאות חיפוש נוספות שתואמות לשאילתה.
debugInfo

object (ResponseDebugInfo)

מידע על ניפוי באגים בתגובה.
errorInfo

object (ErrorInfo)

פרטי השגיאה בתגובה.
resultCounts

object (ResultCounts)

מידע מורחב על מספר התוצאות.

שדה האיחוד result_count. מספר התוצאות הכולל בכל מקורות הנתונים המבוקשים. השדה הזה לא מופיע אם מקורות מוגדרים מראש כלולים בקבוצת מקורות הנתונים שבהם מתבצעת השאילתה. ייתכן שמספרי התוצאות יוחזרו כאומדן, במקום כמספר מדויק, בתנאים הבאים:

  • כשיש יותר מ-2 מונחים בביטוי בשאילתה, כמו "result count exact" במירכאות כפולות.

  • כשמספר רשימות ACL ייחודיות של תוצאות חיפוש שצריך להעריך גדול מדי כדי לחשב אותו תוך זמן אחזור סביר.

במקרים נדירים שבהם המערכת לא מצליחה לחפש בכל המסמכים, צריך להריץ מחדש את השאילתה. הערך של result_count יכול להיות רק אחת מהאפשרויות הבאות:
resultCountEstimate

string (int64 format)

מספר התוצאות המשוער של השאילתה הזו.
resultCountExact

string (int64 format)

מספר התוצאות המדויק של השאילתה הזו.

QueryInterpretation

ייצוג ב-JSON 
{
  "interpretedQuery": string,
  "interpretationType": enum (QueryInterpretation.InterpretationType),
  "reason": enum (QueryInterpretation.Reason),
  "interpretedQueryActualResultCount": integer,
  "interpretedQueryEstimatedResultCount": string
}
שדות
interpretedQuery

string

הפרשנות של השאילתה ששימשה בחיפוש. לדוגמה, שאילתות עם כוונת חיפוש בשפה טבעית כמו 'אימייל מ-John' יפורשו כ-'from:john source:mail'. השדה הזה לא יאוכלס אם הסיבה היא NOT_ENOUGH_RESULTS_FOUND_FOR_USER_QUERY.
interpretationType

enum (QueryInterpretation.InterpretationType)
reason

enum (QueryInterpretation.Reason)

הסיבה לפרשנות של השאילתה. השדה הזה לא יהיה UNSPECIFIED אם סוג הפרשנות לא יהיה NONE.
interpretedQueryActualResultCount

integer

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

string (int64 format)

המספר המשוער של התוצאות שהוחזרו על ידי השאילתה שפורשה.

QueryInterpretation.InterpretationType

טיפוסים בני מנייה (enum)
NONE לא הפרשנות של השפה הטבעית ולא גרסה רחבה יותר של השאילתה משמשות לאחזור תוצאות החיפוש.
BLEND התוצאות מהשאילתה המקורית מעורבבות עם תוצאות אחרות. הסיבה למיזוג של התוצאות האלה עם התוצאות מהשאילתה המקורית תופיע בשדה 'סיבה' שבהמשך.
REPLACE התוצאות מהשאילתה המקורית מוחלפות. הסיבה להחלפת התוצאות מהשאילתה המקורית תופיע בשדה 'סיבה' שבהמשך.

QueryInterpretation.Reason

טיפוסים בני מנייה (enum)
UNSPECIFIED
QUERY_HAS_NATURAL_LANGUAGE_INTENT כדי לאחזר את תוצאות החיפוש, השאילתה מפורשת בשפה טבעית.
NOT_ENOUGH_RESULTS_FOUND_FOR_USER_QUERY הדמיון בין המונחים בשאילתה לבין המונחים במסמך משמש להרחבת השאילתה באופן סלקטיבי כדי לאחזר תוצאות חיפוש נוספות, כי לא נמצאו מספיק תוצאות לשאילתת המשתמש. השאילתה המפורשת תהיה ריקה במקרה הזה.

SearchResult

תוצאות שמכילות מידע שמסומן ב-Google.

ייצוג ב-JSON 
{
  "title": string,
  "url": string,
  "snippet": {
    object (Snippet)
  },
  "metadata": {
    object (Metadata)
  },
  "clusteredResults": [
    {
      object (SearchResult)
    }
  ],
  "debugInfo": {
    object (ResultDebugInfo)
  }
}
שדות
title

string

הכותרת של תוצאת החיפוש.
url

string

כתובת ה-URL של תוצאת החיפוש. כתובת ה-URL מכילה הפניה אוטומטית של Google לפריט בפועל. כתובת ה-URL הזו חתומה ואין לשנות אותה.
snippet

object (Snippet)

שרשור של כל קטעי הקוד (סיכומים) שזמינים לתוצאה הזו.
metadata

object (Metadata)

המטא-נתונים של תוצאת החיפוש.
clusteredResults[]

object (SearchResult)

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

object (ResultDebugInfo)

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

קטע טקסט

קטע מידע של תוצאת החיפוש, שמסכם את התוכן של הדף שנמצא.

ייצוג ב-JSON 
{
  "snippet": string,
  "matchRanges": [
    {
      object (MatchRange)
    }
  ]
}
שדות
snippet

string

קטע הטקסט של המסמך. יכול להיות שהקוד מכיל תו HTML עם תו בריחה (escape) שצריך לבטל את התו בריחה לפני הרינדור.
matchRanges[]

object (MatchRange)

טווחי ההתאמה בקטע הקוד.

MatchRange

טווח ההתאמה של קטע קוד [התחלה, סיום].

ייצוג ב-JSON 
{
  "start": integer,
  "end": integer
}
שדות
start

integer

מיקום ההתחלה של ההתאמה בקטע הקוד.
end

integer

סוף ההתאמה בקטע הקוד.

מטא-נתונים

מטא-נתונים של תוצאת חיפוש תואמת.

ייצוג ב-JSON 
{
  "source": {
    object (Source)
  },
  "mimeType": string,
  "thumbnailUrl": string,
  "owner": {
    object (Person)
  },
  "createTime": string,
  "updateTime": string,
  "fields": [
    {
      object (NamedProperty)
    }
  ],
  "displayOptions": {
    object (ResultDisplayMetadata)
  },
  "objectType": string
}
שדות
source

object (Source)

המקור שצוין לתוצאה, למשל Gmail.
mimeType

string

סוג ה-MIME של תוצאת החיפוש.
thumbnailUrl

string

כתובת ה-URL של התמונה הממוזערת של התוצאה.
owner

object (Person)

הבעלים (בדרך כלל היוצר) של המסמך או האובייקט בתוצאת החיפוש.
createTime

string (Timestamp format)

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

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

string (Timestamp format)

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

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

object (NamedProperty)

שדות שנוספו לאינדקס בנתונים מובְנים, שמוחזרים כנכס גנרי בעל שם.
displayOptions

object (ResultDisplayMetadata)

אפשרויות שמציינות איך להציג תוצאת חיפוש של נתונים מובְנים.
objectType

string

סוג האובייקט של תוצאת החיפוש.

ResultDisplayMetadata

ייצוג ב-JSON 
{
  "objectTypeLabel": string,
  "metalines": [
    {
      object (ResultDisplayMetadata.ResultDisplayLine)
    }
  ]
}
שדות
objectTypeLabel

string

תווית התצוגה של האובייקט.
metalines[]

object (ResultDisplayMetadata.ResultDisplayLine)

תוכן המטאליינים שיוצג עם התוצאה.

ResultDisplayMetadata.ResultDisplayLine

האוסף של השדות שמרכיבים שורה מוצגת

ייצוג ב-JSON 
{
  "fields": [
    {
      object (ResultDisplayMetadata.ResultDisplayField)
    }
  ]
}
שדות
fields[]

object (ResultDisplayMetadata.ResultDisplayField)

ResultDisplayMetadata.ResultDisplayField

הצגת שדות בתוצאות חיפוש

ייצוג ב-JSON 
{
  "label": string,
  "operatorName": string,
  "property": {
    object (NamedProperty)
  }
}
שדות
label

string

תווית התצוגה של הנכס.
operatorName

string

שם המפעיל של הנכס.
property

object (NamedProperty)

צמד השם-ערך של המאפיין.

ResultDebugInfo

מידע על ניפוי הבאגים של התוצאה.

ייצוג ב-JSON 
{
  "formattedDebugInfo": string
}
שדות
formattedDebugInfo

string

מידע כללי על ניפוי הבאגים בפורמט להצגה.

StructuredResult

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

ייצוג ב-JSON 
{

  // Union field structured_result can be only one of the following:
  "person": {
    object (Person)
  }
  // End of list of possible types for union field structured_result.
}
שדות

שדה האיחוד structured_result.

הערך של structured_result יכול להיות רק אחת מהאפשרויות הבאות:
person

object (Person)

ייצוג של אדם

SpellResult

ייצוג ב-JSON 
{
  "suggestedQuery": string,
  "suggestionType": enum (SpellResult.SuggestionType),
  "suggestedQueryHtml": {
    object (SafeHtmlProto)
  }
}
שדות
suggestedQuery

string

הצעת האיות לשאילתה.
suggestionType

enum (SpellResult.SuggestionType)

הצעה שהופעל עבור השאילתה הנוכחית.
suggestedQueryHtml

object (SafeHtmlProto)

ה-HTML המטוהר שמייצג את השאילתה עם תיקון האיות שאפשר להשתמש בה בממשק המשתמש. בדרך כלל יש בו תגים ספציפיים לשפה כדי לסמן חלקים של השאילתה שעוברים בדיקת איות.

SpellResult.SuggestionType

סוג ההצעה שהופעל לשאילתה.

טיפוסים בני מנייה (enum)
SUGGESTION_TYPE_UNSPECIFIED סוג ברירת המחדל של בדיקת האיות
NON_EMPTY_RESULTS_SPELL_SUGGESTION הצעה לאיות בלי שום שינוי בתוצאות. התוצאות עדיין מוצגות לשאילתה המקורית (שיש לה תוצאות שאינן אפס) עם הצעה לאיות שיכול להניב תוצאות.
ZERO_RESULTS_FULL_PAGE_REPLACEMENT ההצעה לאיות מופעלת כשאין תוצאות לשאילתה המקורית. אם אין תוצאות לשאילתה המקורית, אבל יש תוצאות להצעת האיות, אנחנו מפעילים תוצאות לשאילתה עם האיות המתוקן.

SafeHtmlProto

חשוב: לא בטוח לקבל את ההודעה הזו ממקור לא מהימן, כי קל מאוד לתוקף ליצור הודעות בסריאליזציה שלא עומדות בחוזה הבטיחות של הסוג. לדוגמה, ההודעה עשויה להכיל סקריפט בשליטת התוקף. מערכת שמקבלת SafeHtmlProto סומכת באופן משתמע על היוצר של SafeHtmlProto. לכן, בדרך כלל בטוח להחזיר את ההודעה הזו בתשובות RPC, אבל בדרך כלל לא בטוח לקבל אותה בבקשות RPC.

ייצוג ב-JSON 
{
  "privateDoNotAccessOrElseSafeHtmlWrappedValue": string
}
שדות
privateDoNotAccessOrElseSafeHtmlWrappedValue

string

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

FacetResult

תגובה של פן ספציפי למקור

ייצוג ב-JSON 
{
  "sourceName": string,
  "objectType": string,
  "operatorName": string,
  "buckets": [
    {
      object (FacetBucket)
    }
  ]
}
שדות
sourceName

string

שם המקור שאליו מוחזר פלט של תוצאות פנים. השדה לא יהיה ריק.
objectType

string

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

string

השם של האופרטור שנבחר ליצירת פנים. @see cloudsearch.SchemaPropertyOptions
buckets[]

object (FacetBucket)

FacetBuckets לערכים בתגובה שמכילים לפחות תוצאה אחת עם המסנן המתאים.

FacetBucket

קטגוריה במאפיין היא היחידה הבסיסית של הפעולה. קטגוריה יכולה לכלול ערך יחיד או טווח רציף של ערכים, בהתאם לסוג השדה שמחולק לקטגוריות. בשלב זה, המערכת משתמשת ב-FacetBucket רק כדי להחזיר את אובייקט התגובה.

ייצוג ב-JSON 
{
  "count": integer,
  "percentage": integer,
  "filter": {
    object (Filter)
  },

  // Union field bucket_value can be only one of the following:
  "value": {
    object (Value)
  }
  // End of list of possible types for union field bucket_value.
}
שדות
count

integer

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

integer

אחוז התוצאות שתואמות לערך הקטגוריה. הערך המוחזר הוא בין [0-100], והוא מעוגל כלפי מטה למספר שלם אם הוא מכיל שבר. אם הערך לא מוחזר באופן מפורש, הוא מייצג ערך אחוזים שמעוגלים ל-0. אחוזים מוצגים לכל החיפושים, אבל הם משוערים. מאחר שתמיד מוחזרים אחוזים, כדאי להציג אחוזים במקום ספירה.
filter

object (Filter)

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

object (Value)

ResponseDebugInfo

מידע על ניפוי באגים בתגובה.

ייצוג ב-JSON 
{
  "formattedDebugInfo": string
}
שדות
formattedDebugInfo

string

מידע כללי על ניפוי הבאגים בפורמט להצגה.

ErrorInfo

פרטי השגיאה בתגובה.

ייצוג ב-JSON 
{
  "errorMessages": [
    {
      object (ErrorMessage)
    }
  ]
}
שדות
errorMessages[]

object (ErrorMessage)

ErrorMessage

הודעת שגיאה לכל תגובה מהמקור.

ייצוג ב-JSON 
{
  "source": {
    object (Source)
  },
  "errorMessage": string
}
שדות
source

object (Source)
errorMessage

string

ResultCounts

מידע על מספר התוצאות

ייצוג ב-JSON 
{
  "sourceResultCounts": [
    {
      object (SourceResultCount)
    }
  ]
}
שדות
sourceResultCounts[]

object (SourceResultCount)

מספר התוצאות בכל מקור עם תוצאות.

SourceResultCount

מידע על מספר התוצאות לכל מקור.

ייצוג ב-JSON 
{
  "source": {
    object (Source)
  },
  "hasMoreResults": boolean,

  // Union field result_count can be only one of the following:
  "resultCountEstimate": string,
  "resultCountExact": string
  // End of list of possible types for union field result_count.
}
שדות
source

object (Source)

המקור שאליו משויך המידע על מספר התוצאות.
hasMoreResults

boolean

אם יש עוד תוצאות חיפוש עבור המקור הזה.

שדה האיחוד result_count.

הערך של result_count יכול להיות רק אחת מהאפשרויות הבאות:
resultCountEstimate

string (int64 format)

מספר התוצאות המשוער של המקור הזה.
resultCountExact

string (int64 format)

מספר התוצאות המדויק של המקור הזה.