Search

תשובה לבקשת חיפוש מותאמת אישית.

ייצוג JSON 
{
  "kind": string,
  "url": {
    "type": string,
    "template": string
  },
  "queries": {
    "previousPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "request": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "nextPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ]
  },
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}
שדות
kind

string

מזהה ייחודי של סוג האובייקט הנוכחי. ב-API הזה זהו חיפוש מותאם אישית#search.
url

object

רכיב כתובת האתר של OpenSearch שמגדיר את התבנית ל-API הזה.
url.type

string

סוג ה-MIME של תבנית כתובת ה-URL של OpenSearch ל-API בפורמט JSON של חיפוש מותאם אישית.
url.template

string

תבנית OpenSearch בפועל עבור ה-API הזה.
queries

object

מכיל קבוצה אחת או יותר של מטא-נתונים של שאילתה, עם קידוד לפי שם התפקיד. שמות התפקידים האפשריים כוללים את request, שמוגדר על ידי תפקידי שאילתת OpenSearch ושני תפקידים בהתאמה אישית: nextPage ו-previousPage.
queries.previousPage[]

object

מטא-נתונים שמייצגים את דף התוצאות הקודם, אם רלוונטי.
queries.previousPage[].title

string

תיאור השאילתה.
queries.previousPage[].totalResults

string (int64 format)

המספר המשוער של תוצאות החיפוש הכוללות. יכול להיות שהתשובה לא תהיה מדויקת.
queries.previousPage[].searchTerms

string

מונחי החיפוש שהוזנו על ידי המשתמש.
queries.previousPage[].count

integer

מספר תוצאות החיפוש שהוחזרו בקבוצה הזו.
queries.previousPage[].startIndex

integer

האינדקס של הקבוצה הנוכחית של תוצאות החיפוש אל קבוצת התוצאות הכוללת, כאשר האינדקס של התוצאה הראשונה הוא 1.
queries.previousPage[].startPage

integer

מספר הדף של קבוצת התוצאות הזו, שבו אורך הדף מוגדר על ידי המאפיין count.
queries.previousPage[].language

string

השפה של תוצאות החיפוש.
queries.previousPage[].inputEncoding

string

קידוד התווים הנתמך בבקשות חיפוש.
queries.previousPage[].outputEncoding

string

קידוד התווים הנתמך בתוצאות החיפוש.
queries.previousPage[].safe

string

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

  • "off": השבתת החיפוש הבטוח

  • "active": הפעלת החיפוש הבטוח
queries.previousPage[].cx

string

המזהה של מנוע שנוצר באמצעות לוח הבקרה של Programmable Search Engine. זהו מאפיין מותאם אישית שלא מוגדר במפרט OpenSearch. הפרמטר הזה הוא חובה.
queries.previousPage[].sort

string

מציינת שצריך למיין את התוצאות לפי הביטוי שצוין. לדוגמה, מיון לפי תאריך.
queries.previousPage[].filter

string

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

  • 0: מושבת

  • 1: מופעלת (ברירת מחדל)

הערה: כברירת מחדל, Google מחילה את הסינון על כל תוצאות החיפוש כדי לשפר את האיכות של התוצאות האלה.
queries.previousPage[].gl

string

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

ציון ערך הפרמטר gl בבקשות WebSearch אמור לשפר את הרלוונטיות של התוצאות. הדבר נכון במיוחד ללקוחות בינלאומיים, ובמיוחד ללקוחות במדינות דוברות אנגלית מחוץ לארה"ב.
queries.previousPage[].cr

string

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

מערכת Google WebSearch קובעת את המדינה של מסמך באמצעות ניתוח הנתונים הבאים:

  • הדומיין ברמה העליונה (TLD) של כתובת ה-URL של המסמך.

  • המיקום הגיאוגרפי של כתובת ה-IP של שרת האינטרנט.

בקטע ערכי פרמטר מדינה (cr) מופיעה רשימה של ערכים חוקיים לפרמטר הזה.
queries.previousPage[].googleHost

string

מציין את הדומיין של Google (לדוגמה, google.com , google.de או google.fr) שאליו צריך להגביל את החיפוש.
queries.previousPage[].disableCnTwTranslation

string

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

הערכים הנתמכים הם:

  • 0: מופעלת (ברירת מחדל)

  • 1: מושבת
queries.previousPage[].hq

string

מצרף לשאילתה את מונחי השאילתה שצוינו, כאילו הם שולבו עם אופרטור AND לוגי.
queries.previousPage[].hl

string

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

מידע נוסף זמין בקטע שפות ממשק של מצגת בינלאומית של שאילתות ותוצאות. בנוסף, בקטע שפות ממשק נתמכות מופיעה רשימת השפות הנתמכות.
queries.previousPage[].siteSearch

string

הגבלת תוצאות לכתובות URL מאתר ספציפי.
queries.previousPage[].siteSearchFilter

string

המדיניות קובעת אם לכלול או להחריג תוצאות מהאתר שמצוין בפרמטר sitesearch. הערכים הנתמכים הם:

  • i: הכללת תוכן מהאתר

  • e: החרגת תוכן מהאתר
queries.previousPage[].exactTerms

string

מזהה ביטוי שכל המסמכים בתוצאות החיפוש חייבים להכיל.
queries.previousPage[].excludeTerms

string

מזהה מילה או ביטוי שלא אמורים להופיע באף מסמך בתוצאות החיפוש.
queries.previousPage[].linkSite

string

מציינת שכל התוצאות צריכות להכיל קישור לכתובת URL ספציפית.
queries.previousPage[].orTerms

string

מספקת מונחי חיפוש נוספים לבדיקה במסמך, שבהם כל מסמך בתוצאות החיפוש חייב להכיל לפחות אחד ממונחי החיפוש הנוספים. אפשר גם להשתמש במונח השאילתה או בוליאני לשאילתה מהסוג הזה.
queries.previousPage[].relatedSite

string

מציינת שכל תוצאות החיפוש צריכות להיות דפים שקשורים לכתובת ה-URL שצוינה. ערך הפרמטר צריך להיות כתובת URL.
queries.previousPage[].dateRestrict

string

הגבלת תוצאות לכתובות URL לפי תאריך. הערכים הנתמכים כוללים:

  • d[number]: התוצאות של הבקשות ממספר הימים האחרונים שצוין.

  • w[number]: בקשות לתוצאות ממספר השבועות האחרונים שצוינו.

  • m[number]: התוצאות של הבקשות שהתקבלו ממספר החודשים האחרונים שצוין.

  • y[number]: בקשות לתוצאות ממספר השנים האחרונות שצוין.
queries.previousPage[].lowRange

string

מציינת את הערך ההתחלתי של טווח חיפוש. כדי להוסיף לשאילתה טווח חיפוש כולל של lowRange...highRange, צריך להשתמש ב-cse:lowRange וב-cse:highrange.
queries.previousPage[].highRange

string

מציינת את הערך הסופי של טווח חיפוש. כדי להוסיף לשאילתה טווח חיפוש כולל של lowRange...highRange, צריך להשתמש ב-cse:lowRange וב-cse:highrange.
queries.previousPage[].fileType

string

הגבלת התוצאות לקבצים עם סיומת מסוימת. סוגי הקבצים ש-Google תומכת בהם:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • לוטוס 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • loss WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • פורמט טקסט עשיר (rtf)

  • Shockwave Flash (swf)

  • טקסט (ans, txt).

יכול להיות שבעתיד יתווספו סוגי קבצים נוספים. ניתן למצוא רשימה עדכנית תמיד בשאלות הנפוצות על סוגי קבצים של Google.
queries.previousPage[].rights

string

מסננים בהתאם לרישוי. הערכים הנתמכים כוללים:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.previousPage[].searchType

string

הערכים המותרים הם web או image. אם לא צוין אחרת, התוצאות יוגבלו לדפי אינטרנט.
queries.previousPage[].imgSize

string

מגביל תוצאות לתמונות בגודל מסוים. הערכים הנתמכים הם:

  • icon (קטן)

  • small | medium | large | xlarge (בינוני)

  • xxlarge (גדול)

  • huge (גדול מאוד)
queries.previousPage[].imgType

string

הגבלת התוצאות לתמונות מסוג מסוים. הערכים הנתמכים הם:

  • clipart (אוסף גרפיקה)

  • face (פנים)

  • lineart (שרטוט קו)

  • photo (תמונה)

  • animated (אנימציה)

  • stock (מניות)
queries.previousPage[].imgColorType

string

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

  • mono (שחור ולבן)

  • gray (גווני אפור)

  • color (צבע)
queries.previousPage[].imgDominantColor

string

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

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
queries.request[]

object

מטא-נתונים שמייצגים את הבקשה הנוכחית.
queries.request[].title

string

תיאור השאילתה.
queries.request[].totalResults

string (int64 format)

המספר המשוער של תוצאות החיפוש הכוללות. יכול להיות שהתשובה לא תהיה מדויקת.
queries.request[].searchTerms

string

מונחי החיפוש שהוזנו על ידי המשתמש.
queries.request[].count

integer

מספר תוצאות החיפוש שהוחזרו בקבוצה הזו.
queries.request[].startIndex

integer

האינדקס של הקבוצה הנוכחית של תוצאות החיפוש אל קבוצת התוצאות הכוללת, כאשר האינדקס של התוצאה הראשונה הוא 1.
queries.request[].startPage

integer

מספר הדף של קבוצת התוצאות הזו, שבו אורך הדף מוגדר על ידי המאפיין count.
queries.request[].language

string

השפה של תוצאות החיפוש.
queries.request[].inputEncoding

string

קידוד התווים הנתמך בבקשות חיפוש.
queries.request[].outputEncoding

string

קידוד התווים הנתמך בתוצאות החיפוש.
queries.request[].safe

string

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

  • "off": השבתת החיפוש הבטוח

  • "active": הפעלת החיפוש הבטוח
queries.request[].cx

string

המזהה של מנוע שנוצר באמצעות לוח הבקרה של Programmable Search Engine. זהו מאפיין מותאם אישית שלא מוגדר במפרט OpenSearch. הפרמטר הזה הוא חובה.
queries.request[].sort

string

מציינת שצריך למיין את התוצאות לפי הביטוי שצוין. לדוגמה, מיון לפי תאריך.
queries.request[].filter

string

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

  • 0: מושבת

  • 1: מופעלת (ברירת מחדל)

הערה: כברירת מחדל, Google מחילה את הסינון על כל תוצאות החיפוש כדי לשפר את האיכות של התוצאות האלה.
queries.request[].gl

string

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

ציון ערך הפרמטר gl בבקשות WebSearch אמור לשפר את הרלוונטיות של התוצאות. הדבר נכון במיוחד ללקוחות בינלאומיים, ובמיוחד ללקוחות במדינות דוברות אנגלית מחוץ לארה"ב.
queries.request[].cr

string

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

מערכת Google WebSearch קובעת את המדינה של מסמך באמצעות ניתוח הנתונים הבאים:

  • הדומיין ברמה העליונה (TLD) של כתובת ה-URL של המסמך.

  • המיקום הגיאוגרפי של כתובת ה-IP של שרת האינטרנט.

בקטע ערכי פרמטר מדינה (cr) מופיעה רשימה של ערכים חוקיים לפרמטר הזה.
queries.request[].googleHost

string

מציין את הדומיין של Google (לדוגמה, google.com , google.de או google.fr) שאליו צריך להגביל את החיפוש.
queries.request[].disableCnTwTranslation

string

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

הערכים הנתמכים הם:

  • 0: מופעלת (ברירת מחדל)

  • 1: מושבת
queries.request[].hq

string

מצרף לשאילתה את מונחי השאילתה שצוינו, כאילו הם שולבו עם אופרטור AND לוגי.
queries.request[].hl

string

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

לקבלת מידע נוסף, ראה את הקטע שפות ממשק של מצגת בינלאומית בנושא שאילתות ותוצאות ואת רשימת השפות הנתמכות עבור שפות ממשק נתמכות לקבלת רשימת שפות נתמכות.
queries.request[].siteSearch

string

הגבלת תוצאות לכתובות URL מאתר ספציפי.
queries.request[].siteSearchFilter

string

המדיניות קובעת אם לכלול או להחריג תוצאות מהאתר שמצוין בפרמטר sitesearch. הערכים הנתמכים הם:

  • i: הכללת תוכן מהאתר

  • e: החרגת תוכן מהאתר
queries.request[].exactTerms

string

מזהה ביטוי שכל המסמכים בתוצאות החיפוש חייבים להכיל.
queries.request[].excludeTerms

string

מזהה מילה או ביטוי שלא אמורים להופיע באף מסמך בתוצאות החיפוש.
queries.request[].linkSite

string

מציינת שכל התוצאות צריכות להכיל קישור לכתובת URL ספציפית.
queries.request[].orTerms

string

מספקת מונחי חיפוש נוספים לבדיקה במסמך, שבהם כל מסמך בתוצאות החיפוש חייב להכיל לפחות אחד ממונחי החיפוש הנוספים. אפשר גם להשתמש במונח השאילתה או בוליאני לשאילתה מהסוג הזה.
queries.request[].relatedSite

string

מציינת שכל תוצאות החיפוש צריכות להיות דפים שקשורים לכתובת ה-URL שצוינה. ערך הפרמטר צריך להיות כתובת URL.
queries.request[].dateRestrict

string

הגבלת תוצאות לכתובות URL לפי תאריך. הערכים הנתמכים כוללים:

  • d[number]: התוצאות של הבקשות ממספר הימים האחרונים שצוין.

  • w[number]: בקשות לתוצאות ממספר השבועות האחרונים שצוינו.

  • m[number]: התוצאות של הבקשות שהתקבלו ממספר החודשים האחרונים שצוין.

  • y[number]: בקשות לתוצאות ממספר השנים האחרונות שצוין.
queries.request[].lowRange

string

מציינת את הערך ההתחלתי של טווח חיפוש. כדי להוסיף לשאילתה טווח חיפוש כולל של lowRange...highRange, צריך להשתמש ב-cse:lowRange וב-cse:highrange.
queries.request[].highRange

string

מציינת את הערך הסופי של טווח חיפוש. כדי להוסיף לשאילתה טווח חיפוש כולל של lowRange...highRange, צריך להשתמש ב-cse:lowRange וב-cse:highrange.
queries.request[].fileType

string

הגבלת התוצאות לקבצים עם סיומת מסוימת. סוגי הקבצים ש-Google תומכת בהם:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • לוטוס 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • loss WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • פורמט טקסט עשיר (rtf)

  • Shockwave Flash (swf)

  • טקסט (ans, txt).

יכול להיות שבעתיד יתווספו סוגי קבצים נוספים. ניתן למצוא רשימה עדכנית תמיד בשאלות הנפוצות על סוגי קבצים של Google.
queries.request[].rights

string

מסננים בהתאם לרישוי. הערכים הנתמכים כוללים:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.request[].searchType

string

הערכים המותרים הם web או image. אם לא צוין אחרת, התוצאות יוגבלו לדפי אינטרנט.
queries.request[].imgSize

string

מגביל תוצאות לתמונות בגודל מסוים. הערכים הנתמכים הם:

  • icon (קטן)

  • small | medium | large | xlarge (בינוני)

  • xxlarge (גדול)

  • huge (גדול מאוד)
queries.request[].imgType

string

הגבלת התוצאות לתמונות מסוג מסוים. הערכים הנתמכים הם:

  • clipart (אוסף גרפיקה)

  • face (פנים)

  • lineart (שרטוט קו)

  • photo (תמונה)

  • animated (אנימציה)

  • stock (מניות)
queries.request[].imgColorType

string

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

  • mono (שחור ולבן)

  • gray (גווני אפור)

  • color (צבע)
queries.request[].imgDominantColor

string

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

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
queries.nextPage[]

object

מטא-נתונים שמייצגים את דף התוצאות הבא, אם רלוונטי.
queries.nextPage[].title

string

תיאור השאילתה.
queries.nextPage[].totalResults

string (int64 format)

המספר המשוער של תוצאות החיפוש הכוללות. יכול להיות שהתשובה לא תהיה מדויקת.
queries.nextPage[].searchTerms

string

מונחי החיפוש שהוזנו על ידי המשתמש.
queries.nextPage[].count

integer

מספר תוצאות החיפוש שהוחזרו בקבוצה הזו.
queries.nextPage[].startIndex

integer

האינדקס של הקבוצה הנוכחית של תוצאות החיפוש אל קבוצת התוצאות הכוללת, כאשר האינדקס של התוצאה הראשונה הוא 1.
queries.nextPage[].startPage

integer

מספר הדף של קבוצת התוצאות הזו, שבו אורך הדף מוגדר על ידי המאפיין count.
queries.nextPage[].language

string

השפה של תוצאות החיפוש.
queries.nextPage[].inputEncoding

string

קידוד התווים הנתמך בבקשות חיפוש.
queries.nextPage[].outputEncoding

string

קידוד התווים הנתמך בתוצאות החיפוש.
queries.nextPage[].safe

string

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

  • "off": השבתת החיפוש הבטוח

  • "active": הפעלת החיפוש הבטוח
queries.nextPage[].cx

string

המזהה של מנוע שנוצר באמצעות לוח הבקרה של Programmable Search Engine. זהו מאפיין מותאם אישית שלא מוגדר במפרט OpenSearch. הפרמטר הזה הוא חובה.
queries.nextPage[].sort

string

מציינת שצריך למיין את התוצאות לפי הביטוי שצוין. לדוגמה, מיון לפי תאריך.
queries.nextPage[].filter

string

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

  • 0: מושבת

  • 1: מופעלת (ברירת מחדל)

הערה: כברירת מחדל, Google מחילה את הסינון על כל תוצאות החיפוש כדי לשפר את האיכות של התוצאות האלה.
queries.nextPage[].gl

string

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

ציון ערך הפרמטר gl בבקשות WebSearch אמור לשפר את הרלוונטיות של התוצאות. הדבר נכון במיוחד ללקוחות בינלאומיים, ובמיוחד ללקוחות במדינות דוברות אנגלית מחוץ לארה"ב.
queries.nextPage[].cr

string

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

מערכת Google WebSearch קובעת את המדינה של מסמך באמצעות ניתוח הנתונים הבאים:

  • הדומיין ברמה העליונה (TLD) של כתובת ה-URL של המסמך.

  • המיקום הגיאוגרפי של כתובת ה-IP של שרת האינטרנט.

בקטע ערכי פרמטר מדינה (cr) מופיעה רשימה של ערכים חוקיים לפרמטר הזה.
queries.nextPage[].googleHost

string

מציין את דומיין Google (לדוגמה, google.com , google.de או google.fr) שאליו צריך להגביל את החיפוש.
queries.nextPage[].disableCnTwTranslation

string

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

הערכים הנתמכים הם:

  • 0: מופעלת (ברירת מחדל)

  • 1: מושבת
queries.nextPage[].hq

string

מצרף לשאילתה את מונחי השאילתה שצוינו, כאילו הם שולבו עם אופרטור AND לוגי.
queries.nextPage[].hl

string

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

מידע נוסף זמין בקטע שפות ממשק של מצגת בינלאומית של שאילתות ותוצאות. בנוסף, בקטע שפות ממשק נתמכות מופיעה רשימת השפות הנתמכות.
queries.nextPage[].siteSearch

string

הגבלת תוצאות לכתובות URL מאתר ספציפי.
queries.nextPage[].siteSearchFilter

string

המדיניות קובעת אם לכלול או להחריג תוצאות מהאתר שמצוין בפרמטר sitesearch. הערכים הנתמכים הם:

  • i: הכללת תוכן מהאתר

  • e: החרגת תוכן מהאתר
queries.nextPage[].exactTerms

string

מזהה ביטוי שכל המסמכים בתוצאות החיפוש חייבים להכיל.
queries.nextPage[].excludeTerms

string

מזהה מילה או ביטוי שלא אמורים להופיע באף מסמך בתוצאות החיפוש.
queries.nextPage[].linkSite

string

מציינת שכל התוצאות צריכות להכיל קישור לכתובת URL ספציפית.
queries.nextPage[].orTerms

string

מספקת מונחי חיפוש נוספים לבדיקה במסמך, שבהם כל מסמך בתוצאות החיפוש חייב להכיל לפחות אחד ממונחי החיפוש הנוספים. אפשר גם להשתמש במונח השאילתה או בוליאני לשאילתה מהסוג הזה.
queries.nextPage[].relatedSite

string

מציינת שכל תוצאות החיפוש צריכות להיות דפים שקשורים לכתובת ה-URL שצוינה. ערך הפרמטר צריך להיות כתובת URL.
queries.nextPage[].dateRestrict

string

הגבלת תוצאות לכתובות URL לפי תאריך. הערכים הנתמכים כוללים:

  • d[number]: התוצאות של הבקשות ממספר הימים האחרונים שצוין.

  • w[number]: בקשות לתוצאות ממספר השבועות האחרונים שצוינו.

  • m[number]: התוצאות של הבקשות שהתקבלו ממספר החודשים האחרונים שצוין.

  • y[number]: בקשות לתוצאות ממספר השנים האחרונות שצוין.
queries.nextPage[].lowRange

string

מציינת את הערך ההתחלתי של טווח חיפוש. כדי להוסיף לשאילתה טווח חיפוש כולל של lowRange...highRange, צריך להשתמש ב-cse:lowRange וב-cse:highrange.
queries.nextPage[].highRange

string

מציינת את הערך הסופי של טווח חיפוש. כדי להוסיף לשאילתה טווח חיפוש כולל של lowRange...highRange, צריך להשתמש ב-cse:lowRange וב-cse:highrange.
queries.nextPage[].fileType

string

הגבלת התוצאות לקבצים עם סיומת מסוימת. סוגי הקבצים ש-Google תומכת בהם:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • לוטוס 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • loss WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • פורמט טקסט עשיר (rtf)

  • Shockwave Flash (swf)

  • טקסט (ans, txt).

יכול להיות שבעתיד יתווספו סוגי קבצים נוספים. ניתן למצוא רשימה עדכנית תמיד בשאלות הנפוצות על סוגי קבצים של Google.
queries.nextPage[].rights

string

מסננים בהתאם לרישוי. הערכים הנתמכים כוללים:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.nextPage[].searchType

string

הערכים המותרים הם web או image. אם לא צוין אחרת, התוצאות יוגבלו לדפי אינטרנט.
queries.nextPage[].imgSize

string

מגביל תוצאות לתמונות בגודל מסוים. הערכים הנתמכים הם:

  • icon (קטן)

  • small | medium | large | xlarge (בינוני)

  • xxlarge (גדול)

  • huge (גדול מאוד)
queries.nextPage[].imgType

string

הגבלת התוצאות לתמונות מסוג מסוים. הערכים הנתמכים הם:

  • clipart (אוסף גרפיקה)

  • face (פנים)

  • lineart (שרטוט קו)

  • photo (תמונה)

  • animated (אנימציה)

  • stock (מניות)
queries.nextPage[].imgColorType

string

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

  • mono (שחור ולבן)

  • gray (גווני אפור)

  • color (צבע)
queries.nextPage[].imgDominantColor

string

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

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
promotions[]

object (Promotion)

קבוצת מבצעים הצגה רק אם קובצי התצורה של מנוע החיפוש המותאם אישית מגדירים קידומי מכירות לשאילתה הנתונה.
context

object (Struct format)

מטא נתונים ושיפורים המשויכים למנוע החיפוש הנתון, כולל:

  • השם של מנוע החיפוש ששימש לשאילתה.

  • קבוצת אובייקטים של מאפייני (חידודים) שבהם ניתן להשתמש כדי לצמצם חיפוש.
searchInformation

object

מטא-נתונים שקשורים לחיפוש הזה, כולל זמן החיפוש וסה"כ התוצאות.
searchInformation.searchTime

number

הזמן שנדרש לשרת להחזיר תוצאות חיפוש.
searchInformation.formattedSearchTime

string

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

string

המספר הכולל של תוצאות חיפוש שהשאילתה החזירה.
searchInformation.formattedTotalResults

string

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

object

כולל שאילתה מתוקנת.
spelling.correctedQuery

string

השאילתה המתוקנת.
spelling.htmlCorrectedQuery

string

השאילתה המתוקנת, בפורמט HTML.
items[]

object (Result)

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

קידום מכירות

תוצאת קידום המכירות.

ייצוג JSON 
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
שדות
title

string

שם המבצע.
htmlTitle

string

כותרת קידום המכירות, ב-HTML.
bodyLines[]

object

מערך אובייקטים של בלוקים לקידום הזה.
bodyLines[].title

string

הטקסט של אובייקט הבלוק, אם הוא מכיל טקסט.
bodyLines[].htmlTitle

string

הטקסט של אובייקט הבלוק ב-HTML, אם הוא מכיל טקסט.
bodyLines[].url

string

כתובת ה-URL של הקישור של אובייקט החסימה, אם יש לו קישור.
bodyLines[].link

string

הטקסט המקושר של הקישור של אובייקט הבלוק, אם יש לו קישור.
image

object

תמונה שמשויכת למבצע הזה, אם יש כזה.
image.source

string

כתובת ה-URL של התמונה עבור הקישור למבצע.
image.width

integer

רוחב התמונה בפיקסלים.
image.height

integer

גובה התמונה בפיקסלים.

תוצאה

תוצאת חיפוש מותאמת אישית.

ייצוג JSON 
{
  "kind": string,
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "snippet": string,
  "htmlSnippet": string,
  "cacheId": string,
  "formattedUrl": string,
  "htmlFormattedUrl": string,
  "pagemap": {
    object
  },
  "mime": string,
  "fileFormat": string,
  "image": {
    "contextLink": string,
    "height": integer,
    "width": integer,
    "byteSize": integer,
    "thumbnailLink": string,
    "thumbnailHeight": integer,
    "thumbnailWidth": integer
  },
  "labels": [
    {
      "name": string,
      "displayName": string,
      "label_with_op": string
    }
  ]
}
שדות
kind

string

מזהה ייחודי של סוג האובייקט הנוכחי. ב-API הזה הערך הוא customsearch#result.
title

string

הכותרת של תוצאת החיפוש, בטקסט פשוט.
htmlTitle

string

הכותרת של תוצאת החיפוש ב-HTML.
snippet

string

הקטע של תוצאת החיפוש, בטקסט פשוט.
htmlSnippet

string

הקטע של תוצאת החיפוש ב-HTML.
cacheId

string

מציין את המזהה של הגרסה השמורה במטמון של Google לתוצאת החיפוש.
formattedUrl

string

כתובת ה-URL שמוצגת אחרי קטע הקוד של כל תוצאת חיפוש.
htmlFormattedUrl

string

כתובת URL בפורמט HTML שמוצגת אחרי קטע הקוד של כל תוצאת חיפוש.
pagemap

object (Struct format)

מכיל מידע PageMap עבור תוצאת החיפוש הזו.
mime

string

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

string

פורמט הקובץ של תוצאת החיפוש.
image

object

כולל את כל המידע על תמונה שמוחזרת בתוצאות החיפוש.
image.contextLink

string

כתובת URL שמפנה לדף האינטרנט שמארח את התמונה.
image.height

integer

גובה התמונה, בפיקסלים.
image.width

integer

רוחב התמונה, בפיקסלים.
image.byteSize

integer

גודל התמונה, בבייטים.
image.thumbnailLink

string

כתובת URL של התמונה הממוזערת.
image.thumbnailHeight

integer

גובה התמונה הממוזערת, בפיקסלים.
image.thumbnailWidth

integer

רוחב התמונה הממוזערת, בפיקסלים.
labels[]

object

כולל את כל המידע על תוויות החידוד.
labels[].name

string

השם של תווית חידוד, שבה ניתן להשתמש כדי לצמצם חיפושים. אין להציג את הפרטים האלה בממשק המשתמש. במקום זאת, יש להשתמש ב-displayName.
labels[].displayName

string

השם המוצג של תווית חידוד. זה השם שאתם צריכים להציג בממשק המשתמש.
labels[].label_with_op

string

תווית חידוד ופעולת החידוד המשויכת.