背景資訊:定義程式化搜尋引擎

本頁說明如何使用內容檔案定義搜尋引擎規格。

  1. 總覽
  2. CustomSearchEngine 元素

總覽

內容檔案說明瞭搜尋引擎的結構並定義其行為。如要開始瞭解結構定義檔案,最佳方式就是查看簡單的範例。建立信心時,您可能會想嘗試各種元素和屬性。您可以試用「控制台」中的設定,然後在「總覽」頁面查看系統產生的 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 元素

基本結構定義檔案包含下列主要元素和子元素。

元素 需要 說明
CustomSearchEngine 需要 包含搜尋引擎的所有相關資訊。具有下列屬性:
  • keywords:指定與搜尋引擎相關聯的清單 (長度上限為 100 個半形字元)。如未指定,程式化搜尋引擎將使用空白值。
  • language:指定使用者介面中顯示的其中一種支援的語言。指定特定語言會強化該語言的搜尋結果,但不會篩除其他語言的搜尋結果。如未指定,程式化搜尋引擎將使用 en (英文)。如果值為空值,程式化搜尋引擎會使用使用者所在地區的語言。
  • autocompletions。用於指出程式化搜尋引擎是否應為你的搜尋引擎產生詞彙表自動完成建議。允許的值為 truefalse。如果為 true,請注意產生自動完成建議可能需要數小時。設定這個值之後,您必須修改搜尋框程式碼,才能要求提供自動完成建議。您可以在控制台的 [取得程式碼] 分頁中取得更新後的程式碼。只有搜尋包含網站的搜尋引擎 (預先決定的網站組合) 才能提供自動完成查詢。
Title 需要 搜尋引擎的名稱。它會顯示在程式化搜尋引擎首頁和結果頁面中。
Description 需要 搜尋引擎總覽頁面中顯示的說明文字。
Context 需要 保留標籤相關資訊。包含 BackgroundLabelsFacet 子元素。
BackgroundLabels 選用 用來宣傳、納入或排除網站和網頁的標籤容器。包含一或多個子項 Label 元素。
Label 選用 用來宣傳網站的標籤,或判別網站是否納入/排除網站的標籤。具有下列屬性:
  • name:標籤名稱。
  • mode. FILTER (宣傳或只顯示偏好網站) 或 ELIMINATE (排除網站)。您可以視需要自訂這些標籤。
LookAndFeel 需要 控制搜尋引擎的外觀和風格。其中包含多項屬性和子元素,詳情請參閱「外觀與風格」頁面。

ImageSearchSettings 選用

指定是否已啟用圖片搜尋。具有下列屬性:

  • enable. 指定是否要為此搜尋引擎啟用圖片搜尋功能。允許的值為 truefalse