קובץ הקשר מתאר את המבנה של מנוע החיפוש ומגדיר את ההתנהגות שלו. הדרך הטובה ביותר להתחיל ללמוד על קובצי הקשר היא לצפות בדוגמה פשוטה. ככל שתהיו בטוחים יותר בבעיה, תוכלו להתחיל להתנסות ברכיבים שונים ובמאפיינים שונים. אפשר לשחק עם ההגדרות בלוח הבקרה, ולאחר מכן לצפות בגרסת ה-XML שנוצרה בדף סקירה כללית.
הקוד הבא מתאר מנוע חיפוש בנושא שינויי אקלים. שימו לב שבמנוע החיפוש הזה מופעל חיפוש תמונות.
קובץ הקשר בסיסי כולל את הרכיבים העיקריים ורכיבי הצאצא הבאים.
רכיב
חובה
תיאור
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 שם התווית.
modeFILTER (מקדם או מציג באופן בלעדי אתרים מועדפים) או ELIMINATE (ללא האתר). תוכלו להתאים אישית את התוויות האלה לפי הצורך.
LookAndFeel
חובה
המדיניות קובעת את העיצוב והסגנון של מנוע החיפוש. יש לו מספר מאפיינים ורכיבי צאצא שמתוארים בפירוט בדף מראה ותחושה.
ImageSearchSettings
אופציונלי
מציינת אם חיפוש באמצעות תמונות מופעל. כולל את המאפיינים הבאים:
enable מציינת אם החיפוש באמצעות תמונות מופעל במנוע החיפוש הזה. הערכים המותרים הם true או false.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2024-09-12 (שעון UTC)."],[[["Custom Search Ads are customized using parameters categorized by their scope: Page Level, Configuration Settings, and Unit Level."],["Page Level parameters, such as `pubId` and `query`, manage ad behavior across the entire page while Unit Level parameters control individual ad units using attributes like `container` and `width`."],["Configuration settings provide control over aspects like ad filtering (`adsafe`), testing (`adtest`), and language targeting (`hl`)."],["Optional parameters offer further customization, such as defining ad click behavior (`linkTarget`), handling ad loading events (`adLoadedCallback`), and specifying the number of ads to display (`number`)."],["Parameters like `relatedSearchTargeting` and `terms` enable the implementation of related searches, enhancing the user experience by providing relevant content suggestions."]]],[]]