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 הזה מומלץ להשתמש ב-customsearch#search.
url

object

רכיב ה-URL של 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

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

כדי לקבל מידע נוסף, אפשר לעיין בקטע שפות הממשק במאמר Internationalizing שאילתות והצגת תוצאות. לקבלת רשימה של שפות נתמכות, ניתן לעיין בשפות ממשק נתמכות.
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

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

string

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

string

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

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

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

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

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

string

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

string

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

string

הגבלת התוצאות לקבצים של תוסף שצוין. סוגי הקבצים הנתמכים על ידי Google הם:

  • פורמט Adobe Portable Document (pdf)

  • Adobe PostScript (ps)

  • ₹ 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Robot 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

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

כדי לקבל מידע נוסף, אפשר לעיין בקטע שפות הממשק במאמר Internationalizing שאילתות והצגת תוצאות. לקבלת רשימה של שפות נתמכות, ניתן לעיין בשפות ממשק נתמכות.
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

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

string

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

string

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

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

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

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

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

string

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

string

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

string

הגבלת התוצאות לקבצים של תוסף שצוין. סוגי הקבצים הנתמכים על ידי Google הם:

  • פורמט Adobe Portable Document (pdf)

  • Adobe PostScript (ps)

  • ₹ 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Robot 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

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

כדי לקבל מידע נוסף, אפשר לעיין בקטע שפות הממשק במאמר Internationalizing שאילתות והצגת תוצאות. לקבלת רשימה של שפות נתמכות, ניתן לעיין בשפות ממשק נתמכות.
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

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

string

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

string

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

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

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

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

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

string

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

string

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

string

הגבלת התוצאות לקבצים של תוסף שצוין. סוגי הקבצים הנתמכים על ידי Google הם:

  • פורמט Adobe Portable Document (pdf)

  • Adobe PostScript (ps)

  • ₹ 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Robot 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

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