הקשר: הגדרה של Programmable Search Engine

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

  1. סקירה כללית
  2. אלמנטים של מנוע חיפוש מותאם אישית

סקירה כללית

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

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

<CustomSearchEngine keywords="climate &quot;global warming&quot; &quot;greenhouse gases&quot;"
                    language="en">
  <Title>RealClimate</Title>
  <Description>Science behind global warming and climate change.</Description>
  <Context>
    <BackgroundLabels>
      <Label name="_include_" mode="FILTER"/>
      <Label name="_exclude_" mode="ELIMINATE"/>
    </BackgroundLabels>
  </Context>
  <LookAndFeel/>
  <ImageSearchSettings enable="true"/>
</CustomSearchEngine>

רכיבי מנוע חיפוש מותאם אישית

קובץ הקשר בסיסי כולל את הרכיבים העיקריים ואת רכיבי הצאצא הבאים.

רכיב נדרש התיאור
CustomSearchEngine נדרש כולל את כל המידע על מנוע החיפוש. כולל את המאפיינים הבאים:
  • keywords. מציינת רשימה (עד 100 תווים) של מילות מפתח מופרדות ברווחים, שמשויכות למנוע החיפוש. אם לא מציינים שום אפשרות, Programmable Search Engine ישתמש בערך ריק.
  • language. מציינת אחת מהשפות הנתמכות שיוצגו בממשק המשתמש. ציון השפה ישפר את התוצאות בשפה הזו, אבל לא יסנן תוצאות בשפות אחרות. אם לא מציינים שום אפשרות, Programmable Search Engine ישתמש ב-en (אנגלית). אם הערך הוא null, Programmable Search Engine ישתמש בשפת הלוקאל של המשתמש.
  • autocompletions. מציין אם Programmable Search Engine צריך ליצור השלמות אוטומטיות מסוג GLOSSARY למנוע החיפוש שלך. הערכים המותרים הם true או false. אם true, חשוב לזכור שיצירת השלמות אוטומטיות עשויה להימשך מספר שעות. לאחר הגדרת הערך הזה, עליך לשנות את קוד תיבת החיפוש כדי לבקש השלמות אוטומטיות. ניתן לקבל את הקוד המעודכן בכרטיסייה קבלת קוד בלוח הבקרה. רק מנועי חיפוש שכוללים אתרים – אוסף קבוע מראש של אתרים – יכולים לכלול שאילתות בהשלמה אוטומטית.
Title נדרש שם מנוע החיפוש שלך. היא מופיעה בדף הבית של Programmable Search Engine ובדפי התוצאות.
Description נדרש הטקסט התיאורי שמופיע בדף הסקירה הכללית של מנוע החיפוש.
Context נדרש מכיל מידע על תוויות. כולל את רכיבי הצאצא BackgroundLabels ו-Facet.
BackgroundLabels אופציונלי מאגר לתוויות המשמשות לקידום, להכללה או להחרגה של אתרים ודפים. כולל רכיב צאצא אחד או יותר של Label.
Label אופציונלי תווית המשמשת לקידום אתרים או לקביעת הכללה/אי-הכללה של אתרים. כולל את המאפיינים הבאים:
  • name. שם התווית.
  • mode. FILTER (מקדמה או מציגה באופן בלעדי אתרים מועדפים) או ELIMINATE (לא כולל אתר). אפשר להתאים אישית את התוויות האלה לפי הצורך.
LookAndFeel נדרש ההגדרה הזו קובעת את העיצוב והסגנון של מנוע החיפוש. הוא כולל מספר מאפיינים ורכיבי צאצא המתוארים בפירוט בדף מראה ותחושה.

ImageSearchSettings אופציונלי

המדיניות קובעת אם 'חיפוש באמצעות תמונות' מופעל. כולל את המאפיינים הבאים:

  • enable. מציין אם 'חיפוש באמצעות תמונות' מופעל עבור מנוע החיפוש הזה. הערכים המותרים הם true או false.