Method: cse.list

string

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

ערך ברירת המחדל של הפרמטר הזה הוא 0 (אפס), כלומר התכונה מופעלת. הערכים הנתמכים הם:

• 1: מושבת

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

string

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

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

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

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

רשימה של ערכים חוקיים לפרמטר הזה מופיעה בדף ערכים של פרמטר מדינה.

string

מזהה Programmable Search Engine שישמש בבקשה הזו.

string

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

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

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

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

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

string

מזהה ביטוי שכל המסמכים בתוצאות החיפוש חייבים להכיל.

string

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

string

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

string

המדיניות הזו קובעת אם מפעילים או משביתים את מסנן התוכן הכפול.

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

• כברירת מחדל, Google מחילה את הסינון על כל תוצאות החיפוש כדי לשפר את האיכות של התוצאות האלה.

הערכים הקבילים הם:

• 0: השבתה של מסנן התוכן הכפול.

• 1: הפעלה של מסנן התוכן הכפול.

string

המיקום הגיאוגרפי של משתמש הקצה.

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

• ציון ערך הפרמטר gl אמור להוביל לתוצאות רלוונטיות יותר. הדבר נכון במיוחד ללקוחות בינלאומיים, ובאופן ספציפי יותר ללקוחות במדינות דוברות אנגלית מחוץ לארה"ב.

string

הוצא משימוש. כדי להשיג השפעה דומה, משתמשים בפרמטר gl.

הדומיין המקומי של Google (לדוגמה, google.com , google.de או google.fr) שבו רוצים להשתמש לביצוע החיפוש.

string

מציינת את ערך הסיום של טווח חיפוש.

• אפשר להשתמש ב-lowRange וב-highRange כדי לצרף לשאילתה טווח חיפוש כולל של lowRange...highRange.

string

המדיניות הזו מגדירה את שפת ממשק המשתמש.

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

• כדי לקבל מידע נוסף, אפשר לעיין בקטע שפות הממשק במאמר Internationalizing שאילתות והצגת תוצאות. לקבלת רשימה של שפות נתמכות, ניתן לעיין בשפות ממשק נתמכות.

string

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

enum (ImgColorType)

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

• "color"

• "gray"

• "mono": שחור ולבן

• "trans": רקע שקוף

enum (ImgDominantColor)

מחזירה תמונות בצבע דומיננטי מסוים. הערכים הקבילים הם:

• "black"

• "blue"

• "brown"

• "gray"

• "green"

• "orange"

• "pink"

• "purple"

• "red"

• "teal"

• "white"

• "yellow"

enum (ImgSize)

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

• "huge"

• "icon"

• "large"

• "medium"

• "small"

• "xlarge"

• "xxlarge"

enum (ImgType)

מחזירה תמונות מסוג. הערכים הקבילים הם:

• "clipart"

• "face"

• "lineart"

• "stock"

• "photo"

• "animated"

string

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

string

מציינת את הערך ההתחלתי של טווח חיפוש. אפשר להשתמש ב-lowRange וב-highRange כדי לצרף לשאילתה טווח חיפוש כולל של lowRange...highRange.

string

מגבילה את החיפוש למסמכים שנכתבו בשפה מסוימת (למשל, lr=lang_ja).

הערכים הקבילים הם:

• "lang_ar": ערבית

• "lang_bg": בולגרית

• "lang_ca": קטלאנית

• "lang_cs": צ'כית

• "lang_da": דנית

• "lang_de": גרמנית

• "lang_el": יוונית

• "lang_en": אנגלית

• "lang_es": ספרדית

• "lang_et": אסטונית

• "lang_fi": פינית

• "lang_fr": צרפתית

• "lang_hr": קרואטית

• "lang_hu": הונגרית

• "lang_id": אינדונזית

• "lang_is": איסלנדית

• "lang_it": איטלקית

• "lang_iw": עברית

• "lang_ja": יפנית

• "lang_ko": קוריאנית

• "lang_lt": ליטאית

• "lang_lv": לטבית

• "lang_nl": הולנדית

• "lang_no": נורווגית

• "lang_pl": פולנית

• "lang_pt": פורטוגזית

• "lang_ro": רומנית

• "lang_ru": רוסית

• "lang_sk": סלובקית

• "lang_sl": סלובנית

• "lang_sr": סרבית

• "lang_sv": שוודית

• "lang_tr": טורקית

• "lang_zh-CN": סינית (פשוטה)

• "lang_zh-TW": סינית (מסורתית)

integer

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

• הערכים החוקיים הם מספרים שלמים בין 1 ל-10, כולל.

string

מספק מונחי חיפוש נוספים לבדיקה במסמך, כשכל מסמך בתוצאות החיפוש חייב להכיל לפחות אחד ממונחי החיפוש הנוספים.

string

שאילתה

string

הוּצא משימוש.

string

מסננים שמבוססים על רישוי. הערכים הנתמכים כוללים: cc_publicdomain, cc_attribute, cc_sharealike, cc_noncommercial, cc_nonderived ושילובים של הערכים האלה. מידע נוסף זמין בשילובים אופייניים.

enum (Safe)

רמת הבטיחות של החיפוש. הערכים הקבילים הם:

• "active": הפעלת הסינון של החיפוש הבטוח.

• "off": משבית את הסינון של חיפוש בטוח. (ברירת מחדל)

enum (SearchType)

מציין את סוג החיפוש: image. אם לא צוין אחרת, התוצאות מוגבלות לדפי אינטרנט.

הערכים הקבילים הם:

• "image": חיפוש תמונות בהתאמה אישית.

string

מציינת אתר נתון שתמיד צריך לכלול או להחריג מהתוצאות (מידע נוסף מופיע בפרמטר siteSearchFilter בהמשך).

enum (SiteSearchFilter)

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

הערכים הקבילים הם:

• "e": לא לכלול

• "i": כולל

string

ביטוי המיון שיש להחיל על התוצאות. פרמטר המיון מציין שהתוצאות ימוינו לפי הביטוי שצוין, כלומר מיון לפי תאריך. דוגמה: sort=date.

integer (uint32 format)

האינדקס של התוצאה הראשונה שיש להחזיר. מספר ברירת המחדל של תוצאות לדף הוא 10, כך ש-&start=11 יתחיל בראש דף התוצאות השני. הערה: JSON API לעולם לא יחזיר יותר מ-100 תוצאות, גם אם יותר מ-100 מסמכים תואמים לשאילתה, ולכן הגדרת הסכום של start + num למספר גדול מ-100 תיצור שגיאה. כמו כן, חשוב לשים לב שהערך המקסימלי של num הוא 10.