דף זה תורגם על ידי Cloud Translation API.

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

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

סקירה כללית
רכיבים של מנוע חיפוש מותאם אישית

סקירה כללית

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

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

<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`.