הפניה לממשק API של XML

הדף הזה מתייחס לגרסת ה-XML של Custom Search JSON API, שזמינה רק לקוחות של Google Site Search.

1. סקירה כללית
2. פורמט הבקשה של Programmable Search Engine
   1. בקשת סקירה כללית
   2. תנאי השאילתה
   3. הפרמטרים של הבקשה
      1. שאילתות לדוגמה של WebSearch
      2. הגדרות פרמטרים של שאילתת WebSearch
      3. חיפוש מתקדם
      4. פרמטרים מתקדמים של שאילתות חיפוש
      5. תנאים מיוחדים לשאילתה
      6. שאילתות עם תמונה לדוגמה
      7. פרמטרים של שאילתות חיפוש באמצעות תמונות
      8. הגבלות על בקשות
   4. מצגת בינלאומית של שאילתות ותוצאות
      1. קידוד תווים
      2. שפות ממשק
      3. חיפוש בסינית פשוטה ומסורתית
   5. סינון התוצאות
      1. סינון אוטומטי של תוצאות החיפוש
      2. סינון לפי שפות ומדינות
      3. סינון תוכן למבוגרים בלבד באמצעות החיפוש הבטוח
3. תוצאות XML
   1. תוצאות DTD של Google XML
   2. מידע על תגובת ה-XML
   3. תוצאות XML עבור רגיל, תמונה ו שאילתות חיפוש מתקדם
      1. חיפוש רגיל/מתקדם: שאילתה לדוגמה ותוצאת XML
      2. חיפוש רגיל/מתקדם: תגי XML
      3. תוצאות XML לשאילתות של חיפוש תמונות
      4. חיפוש תמונות: שאילתה לדוגמה ותוצאת XML
      5. חיפוש תמונות: תגי XML

סקירה כללית

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

כדי לאחזר תוצאות של Google WebSearch, האפליקציה שלך שולחת ב-Google, בקשת HTTP פשוטה. לאחר מכן Google מחזירה תוצאות חיפוש ב-XML הפורמט. תוצאות בפורמט XML מאפשרות לבצע התאמה אישית באופן שבו תוצאות החיפוש מוצגות.

פורמט הבקשה של WebSearch

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

סקירה כללית של הבקשה

הבקשה של חיפוש Google היא פקודת GET רגילה של HTTP. הוא הדוח כולל אוסף של פרמטרים שרלוונטיים שאילתות. הפרמטרים האלה נכללים בכתובת ה-URL של הבקשה בתור name=value זוגות שמופרדים באמצעות תווי אמפרסנד (&). הפרמטרים כוללים נתונים כמו שאילתת החיפוש ומזהה מנוע חיפוש ייחודי (cx) שמזהה את שמבצע את בקשת ה-HTTP. השירות WebSearch או Image Search מחזיר XML התוצאה היא בקשות ה-HTTP שלכם.

מונחי השאילתה

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

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

• מילים או ביטויים להכללה או לא לכלול
  • כל המילים בשאילתת החיפוש (ברירת מחדל)
  • ביטוי מדויק בשאילתת החיפוש
  • כל מילה או ביטוי בשאילתת חיפוש
• איפה במסמך מחפשים את מונחי חיפוש
  • במקום כלשהו במסמך (ברירת מחדל)
  • רק בגוף המסמך
  • רק בכותרת המסמך
  • רק בכתובת ה-URL של המסמך
  • רק בקישורים במסמך
• הגבלות על המסמכים עצמם
  • הכללה או החרגה של מסמכים מסוגי קבצים מסוימים (כמו קובצי PDF או מסמכי Word)
• שאילתות מיוחדות על כתובות URL שמחזירות מידע על כתובת URL מסוימת, במקום לבצע חיפוש
  • שאילתות שמחזירות מידע כללי על כתובת URL, כמו הקטגוריה, קטע הטקסט או השפה של הספרייה הפתוחה
  • שאילתות המחזירות קבוצה של דפי אינטרנט המקשרים לכתובת URL
  • שאילתות שמחזירות קבוצה של דפי אינטרנט שדומים לכתובת URL נתונה

חיפוש ברירת המחדל

ערכי הפרמטרים של שאילתות החיפוש צריכים להיות מסומנים בתווי בריחה (escape) בכתובת URL. שימו לב: יחליף את סימן הפלוס ("+") בכל רצף של רווח לבן שאילתת החיפוש. הנושא הזה מוסבר בפירוט בקטע הסרת כתובת URL מ-URL במסמך הזה.

מונח שאילתת החיפוש נשלח לשירות WebSearch באמצעות הפרמטר q. א' מונח שאילתת החיפוש לדוגמה הוא:

q=horses+cows+pigs

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

הפרמטרים של הבקשה

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

נדרשים שלושה פרמטרים של הבקשה:

• יש להגדיר את הפרמטר client כ-google-csbe
• הפרמטר output מציין את פורמט של תוצאות ה-XML המוחזרות; ניתן להחזיר תוצאות עם (xml) או ללא (xml_no_dtd) הפניה למספר DTD של Google. ההמלצות שלנו הגדרת הערך הזה ל-xml_no_dtd. הערה: אם לא מציינים את הפרמטר הזה, התוצאות יוחזרו HTML במקום XML.
  
• הפרמטר cx שמייצג את הערך מזהה המנוע.
  

הפרמטרים הנפוצים ביותר של בקשות, מלבד הפרמטרים שהוזכרו למעלה הן:

• num – המספר המבוקש של תוצאות החיפוש
• q – מונחי החיפוש
• start – האינדקס ההתחלתי של התוצאות

שאילתות לדוגמה ב-WebSearch

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

בבקשה הזו מבקשת את 10 התוצאות הראשונות (start=0&num=10) עבור מונח השאילתה 'רד סוקס' (q=red+sox). השאילתה גם מציין שהתוצאות צריכות להגיע מאתרי אינטרנט קנדיים (cr=countryCA) וצריך לכתוב אותן בצרפתית (lr=lang_fr). לבסוף, מציין ערכים עבור הלקוח, פלט, ו-cx, וכל שלושת הפרמטרים האלה נדרשים.

http://www.google.com/search?
  start=0
  &num=10
  &q=red+sox
  &cr=countryCA
  &lr=lang_fr
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

בדוגמה הזו נשתמש בחלק משאילתת החיפוש המתקדם כדי להתאים אישית עוד יותר את שאילתת החיפוש. הבקשה הזו משתמשת בפונקציה as_q הפרמטר (as_q=red+sox) במקום הפרמטר q. הוא גם משתמש as_eq כדי להחריג מסמכים שמכילים את המילה 'Yankees' מ- תוצאות החיפוש (as_eq=yankees).

http://www.google.com/search?
  start=0
  &num=10
  &as_q=red+sox
  &as_eq=Yankees
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i  

הגדרות פרמטרים של שאילתת WebSearch

    <!DOCTYPE GSP SYSTEM "google.dtd">

חיפוש מתקדם

הפרמטרים הנוספים של שאילתות שמפורטים מתחת לתמונה רלוונטיים לשאילתות של חיפוש מתקדם. כששולחים חיפוש מתקדם, הערכים של כמה פרמטרים (למשל, as_eq, as_epq, as_oq וכדומה) משוקללים בשאילתה מונחים לחיפוש. תמונה שבה מוצג הדף 'חיפוש מתקדם' של Google. בתמונה מופיע השם של פרמטר החיפוש המתקדם כתוב בטקסט אדום בתוך או לידו השדה בדף שאליו הפרמטר תואם.

פרמטרים של שאילתות חיפוש מתקדם

תנאים מיוחדים לשאילתות

Google WebSearch מאפשר להשתמש במספר מונחי שאילתה מיוחדים גישה ליכולות נוספות של מנוע החיפוש של Google. האלה צריך לכלול מונחי שאילתות מיוחדים בערך של פרמטר הבקשה q. כמו מונחי שאילתה אחרים, מונחי שאילתה מיוחדים צריכים להיות מסומנים בתו בריחה (escape) בכתובת URL. א' מספר מונחי השאילתה המיוחדים מכילים נקודתיים (:). התו הזה חייב להיות גם בכתובת URL עם תו בריחה (escape), הערך של כתובת ה-URL שמסומנת בתו בריחה (escape) הוא %3A.

שאילתות תמונה לדוגמה

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

הבקשה הזו מבקשת את 5 התוצאות הראשונות (start=0&num=5) עבור מונח השאילתה "קוף" (q=monkey), מסוג קובץ .png לבסוף, השאילתה מציינת ערכים לפרמטרים client, output ו-cx, וכל שלושתם נדרשים.

http://www.google.com/cse?
  searchtype=image
  start=0
  &num=5
  &q=monkey
  &as_filetype=png
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

פרמטרים של שאילתת חיפוש תמונות

מגבלות של בקשות

התרשים הבא מפרט את המגבלות על בקשות החיפוש שליחה ל-Google:

הצגת שאילתות ותוצאות בינלאומיות

שירות Google WebSearch מאפשר לך לחפש מסמכים בשפות מרובות. אפשר לציין את קידוד התווים לשמש לפירוש בקשת ה-HTTP ולקידוד תגובת ה-XML (באמצעות החיפוש ie ו-oe ). אפשר גם לסנן את התוצאות כך שיכללו מסמכים בלבד שכתוב בשפות מסוימות.

בקטעים הבאים נדון בבעיות שקשורות לחיפוש ב- במספר שפות:

• תו קידוד
• שפות ממשק
• סינית פשוטה ומסורתית רשת החיפוש

קידוד תווים

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

אפשר להשתמש בפרמטר של הבקשה ie כדי לציין את מנגנון הקידוד של התווים בבקשת ה-HTTP. אפשר להשתמש גם בפרמטר oe כדי לציין את הקידוד ש-Google צריכה להשתמש בה כדי לקודד את תגובת ה-XML. אם אתם באמצעות סכימת קידוד אחרת מ-ISO-8859-1 (או latin1), חשוב לציין את הערכים הנכונים לפרמטרים ie ו-oe.

הערה: אם אתם מספקים פונקציונליות חיפוש עבור כמה שפות, מומלץ להשתמש בערך הקידוד utf8 (UTF-8) גם לפרמטר ie וגם לפרמטר oe.

אפשר לעיין בקטע התו נספח בנושא סכימות קידוד לרשימה מלאה של הערכים אפשר להשתמש בהם בפרמטרים ie ו-oe.

מידע כללי נוסף על קידוד תווים זמין בכתובת http://www.w3.org/TR/REC-html40/charset.html.

שפות ממשק

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

מומלץ להגדיר במפורש את הפרמטר hl בתוצאות החיפוש כדי להבטיח ש-Google תבחר תוצאות חיפוש לכל שאילתה.

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

חיפוש מסמכים שנכתבו בשפות מסוימות

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

הפרמטר lr תומך באופרטורים בוליאניים כדי לאפשר לציין שפות מרובות שצריך לכלול (או לא לכלול) בחיפוש תוצאות.

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

עבור מסמכים שנכתבו ביפנית:

lr=lang_jp

למסמכים שנכתבו באיטלקית או בגרמנית:

lr=lang_it|lang_de

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

lr=(-lang_hu).(-lang_cs)

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

חיפוש בסינית פשוטה ומסורתית

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

כדי להשתמש בתכונה הזו:

1. מגדירים את פרמטר הבקשה c2coff ל-0
   וגם
2. מבצעים את אחת מהפעולות האלה:
   • אין להגדיר את פרמטר הבקשה lr
     או
   • מגדירים את פרמטר הבקשה lr ל-lr=lang_zh-TW|lang_zh-CN

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

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

סינון תוצאות

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

• אוטומטי סינון תוצאות החיפוש
• סינון לפי שפות ומדינות
• סינון תוכן למבוגרים בלבד באמצעות SafeSearch

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

במסגרת המאמצים שלנו לספק את תוצאות החיפוש הרלוונטיות ביותר, Google משתמשת בשתי שיטות לסינון אוטומטי של תוצאות חיפוש נחשבות בדרך כלל לא רצויות:

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

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

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

סינון לפי שפה ומדינה

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

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

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

• הדומיין ברמה העליונה (TLD) של כתובת ה-URL של המסמך
• מטא תגים של שפה בתוך המסמך
• השפה הראשית שבה כתוב הטקסט במסמך

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

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

• הדומיין ברמה העליונה (TLD) של כתובת ה-URL של המסמך
• המיקום הגיאוגרפי של כתובת ה-IP של שרת האינטרנט

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

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

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

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

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

תכונת החיפוש הבטוח זמינה בשפות הבאות:

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

אם החיפוש הבטוח מופעל ומוצאים אתרים שכוללים כדי להציג תוכן פוגעני בתוצאות החיפוש, יש לשלוח אימייל לכתובת safesearch@google.com. יחקור את האתר.

תוצאות XML

• קובץ XML של Google תוצאות DTD
• מידע על תגובת ה-XML
• XML תוצאות של שאילתות חיפוש רגילות ומתקדם
• חיפוש רגיל/מתקדם: שאילתה לדוגמה ותוצאת XML
• חיפוש רגיל/מתקדם: תגי XML

תוצאות Google XML DTD

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

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

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

בנוסף, אל תגדירו את מנתח ה-XML כך שיאחזר את DTD בכל פעם ששולחים בקשת חיפוש. Google מעדכנת את DTD לעיתים רחוקות, והבקשות האלה גורמות לעיכוב ולרוחב פס מיותרים בדרישות שלנו.

Google ממליצה להשתמש בפורמט הפלט xml_no_dtd כדי לקבל תוצאות XML. אם מציינים את פורמט XML פלט בבקשת החיפוש, ההבדל היחיד הוא הכללת השורה הבאה בתוצאות ה-XML:

<!DOCTYPE GSP SYSTEM "google.dtd">

אפשר לגשת למספר DTD העדכני בכתובת http://www.google.com/google.dtd.

לתשומת ליבכם: יכול להיות שלא כל התכונות ב-DTD יהיו זמינות או נתמכות בשלב זה.

מידע על תגובת XML

• כל ערכי הרכיבים הם HTML תקין שמתאים להצגה, אלא אם צוין אחרת בהגדרות של תגי XML.
• חלק מערכי הרכיבים הם כתובות URL שצריך לקודד ב-HTML לפני כן הם מוצגים.
• מנתח ה-XML צריך להתעלם ממאפיינים ומתגים לא מתועדים. כך האפליקציה יכולה להמשיך לפעול ללא שינויים למשל, אם Google מוסיפה עוד תכונות לפלט ה-XML.
• יש תווים שצריך לסמן בתו בריחה (escape) כשהם נכללים כערכים ב- תגי XML. מעבד ה-XML שלכם צריך להמיר את הישויות האלה בחזרה את התווים המתאימים. אם לא תמירו ישויות באופן תקין, לדוגמה, הדפדפן עשוי לעבד את & בתו '&'. ה-XML מסמכים סטנדרטיים של התווים האלה. התווים האלה בטבלה הבאה:

  תו	טפסים מילוט	ישות	קוד תו
  סימן 'גם' (אמפרסנד)	&	&	&
  גרש	'	'	'
  מירכאות כפולות	"	"	"
  גדול מ-	>	>	>
  קטן מ-	<	&lt;	&#60;

תוצאות XML לשאילתות חיפוש רגילות ומתקדם

חיפוש רגיל/מתקדם: שאילתה לדוגמה ותוצאת XML

בבקשת WebSearch לדוגמה הזו יש 10 תוצאות (num=10) על מונח החיפוש "socer" (q=socer), זו המילה 'כדורגל' איות שגוי בכוונה עבור הדוגמה הזו).

http://www.google.com/search?
    q=socer
    &hl=en
    &start=10
    &num=10
    &output=xml
    &client=google-csbe
    &cx=00255077836266642015:u-scht7a-8i 

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

<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>

<GSP VER="3.2">
   <TM>0.452923</TM>
   <Q>socer</Q>

<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
   <PARAM name="hl" value="en" original_value="en"/>
   <PARAM name="q" value="socer" original_value="socer"/>
   <PARAM name="output" value="xml" original_value="xml"/>
   <PARAM name="client" value="google-csbe" original_value="google-csbe"/>
   <PARAM name="num" value="10" original_value="10"/>
   <Spelling>
      <Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
   </Spelling>
   <Context>

<title>Sample Vacation CSE</title>
    <Facet>
      <FacetItem>
        <label>restaurants</label>
        <anchor_text>restaurants</anchor_text>
      </FacetItem>
      <FacetItem>
        <label>wineries</label>
        <anchor_text>wineries</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>golf_courses</label>
        <anchor_text>golf courses</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
     <FacetItem>
        <label>hotels</label>
        <anchor_text>hotels</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>nightlife</label>
        <anchor_text>nightlife</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>soccer_sites</label>
        <anchor_text>soccer sites</anchor_text>
      </FacetItem>
    </Facet>
   </Context>
   <RES SN="1" EN="10">
      <M>6080</M>
      /*
       * The FI tag after the comment indicates that the result
       * set has been filtered. If the number of results were exact, the
       * FI tag would be replaced by an XT tag in the same format.
       */
      <FI />
      <NB>
         /*
          * Since the request is for the first page of results, the PU tag,
          * which contains a link to the previous page of search results,
          * is not included in this XML result. If the sample result did include
          * a previous page of results, it would be listed here, in the same format
          * as the NU tag on the following line
          */
         <NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
      </NB>
      <R N="1">
         <U>http://www.soccerconnection.net/</U>
         <UE>http://www.soccerconnection.net/</UE>
         <T>SoccerConnection.net</T>
              <CRAWLDATE>May 21, 2007</CRAWLDATE>
         <S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
  <Label>transcodable_pages</Label>
    <Label>accessible</Label>
         <Label>soccer_sites</Label>
         <LANG>en</LANG>
         <HAS>
            <DI>
               <DT>SoccerConnection.net</DT>
               <DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
            </DI>
            <L/>
            <C SZ="8k" CID="kWAPoYw1xIUJ"/>
            <RT/>
         </HAS>
      </R>
      /*
       * The result includes nine more results, each enclosed by an R tag.
       */
   </RES>
</GSP>

חיפוש רגיל/מתקדם: תגי XML

תגובות XML לבקשות חיפוש רגילות ולחיפוש מתקדם שתי הבקשות משתמשות באותה קבוצה של תגי XML. תגי ה-XML האלה מוצגים את קוד ה-XML שלמעלה, ומוסבר בטבלאות שלמטה.

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

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

This example uses the refinement label golf_courses to
filter search results about Palm Springs:
    q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
    q=Palm+Springs+more%3Agolf_courses

תוצאות XML לשאילתות של חיפוש תמונות

בבקשת התמונה לדוגמה הזו מוצגות 5 תוצאות (מספר=5) לגבי מונח החיפוש "קוף" (q=monkey).

http://www.google.com/cse?
  searchtype=image
  &num=2
  &q=monkey
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

הבקשה הזו מניבה את תוצאת ה-XML הבאה.

<GSP VER="3.2">
  <TM>0.395037</TM>
  <Q>monkeys</Q>

  <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/>
  <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/>
  <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/>
  <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/>
  <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/>
  <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/>
  <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/>
  <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/>

  <Context>
    <title>domestigeek</title>
  </Context>

  <ARES/>
  <RES SN="1" EN="2">
    <M>2500000</M>
    <NB>
      <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd
        &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N
      </NU>
    </NB>
    <RG START="1" SIZE="2"/>
      <R N="1" MIME="image/jpeg">
        <RU>http://www.flickr.com/photos/fncll/135465558/</RU>
        <U>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </UE>
        <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T>
        <RK>0</RK>
        <BYLINEDATE>1146034800</BYLINEDATE>
        <S>Computer <b>Monkeys</b> | Flickr</S>
        <LANG>en</LANG>
        <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs">
          <SZ>88386</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi-
t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/>
      </R>
      <R N="2" MIME="image/jpeg">
        <RU>
          http://www.flickr.com/photos/flickerbulb/187044366/
        </RU>
        <U>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </UE>
        <T>
          one. ugly. <b>monkey</b>. | Flickr - Photo Sharing!
        </T>
        <RK>0</RK>
        <BYLINEDATE>1152514800</BYLINEDATE>
        <S>one. ugly. <b>monkey</b>.</S>
        <LANG>en</LANG>
        <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw-
           EF4tQQnDDKOq0"><SZ>58339</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ
          Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/>
      </R>
  </RES>
</GSP>

חיפוש באמצעות תמונות: תגי XML

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

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