資源

連結的自訂搜尋引擎

在 [連結的 CSE] 中，搜尋引擎的規格會存放在您的網站上。在 [Google 儲存的 CSE] 中，搜尋引擎的規格則會存放在 Google。

使用傳統的「Google 儲存 CSE」時，您可以透過兩種方式建立 CSE：登入並使用精靈介面，或編寫 XML 檔案並上載至 Google (透過 [進階] 標籤)。您所使用的搜尋框程式碼會使用「cx」參數，指向這個儲存在 Google 伺服器上的規格資料。如要變更這個 CSE 的任何元素，您必須使用控制台或上載新的 XML 規格，而這會產生幾項限制：

建立和維護 CSE 都是手動的程序。
建立大量 CSE 是相當困難的事，譬如為您的每個使用者建立個別的 CSE，或為您的每個網頁建立稍微不同的 CSE。
使用其他資料來源如 iCal、RSS、Google Base 等來有系統的建立 CSE 是件相當困難的事。

「連結的自訂搜尋引擎」能克服「Google 儲存 CSE」的限制。使用「連結的自訂搜尋引擎」，您可以在自己的網站上放置 CSE 規格，並在 CSE 搜尋要求中納入這個規格的網址。使用者在 CSE 中搜尋時，Google 將從您的網站擷取這個 CSE 規格。這種作法有幾個重要優點：

您可以輕易將您的資料轉換至「自訂搜尋引擎」。
您可以自動產生任何數量的 CSE，讓每一個 CSE 專屬於特定使用者、特定網頁、特定時間等。實際上，您可以產生即時的 CSE 來回應使用者的查詢或使用者在您網站上進行搜尋的網頁。我們提供多個有趣的工具，例如根據某個網頁上可使用的連結來建立 [連結的 CSE]。
您可以輕鬆更新您的 [連結的 CSE] 定義而不需將資料上載至 Google。
沒有全域或個別使用者的註釋限制。

您現在可以盡情發揮您的想像力來動態產生 CSE。我們和第三方提供的工具可讓您輕鬆將 CSE 與您自己的和其他人的網站保持同步化。 iCal 資訊提供、您的推薦連結標誌和使用者的書籤或瀏覽記錄，都是可用來建立 CSE 的有趣資料來源。您甚至可以變更您 CSE 的外觀和風格，來因應您網站的使用狀況和流量。發揮想像力 - 創造無窮的可能！

CSE 規格可參照到一個或多個外部註釋檔案。如此在 CSE 之間共用註釋就會較為容易。

請注意，「連結的自訂搜尋引擎」無法使用「Google 儲存 CSE」的部分功能，例如協同作業和「Google 標記」。如果您已將註解交由 Google 儲存，您可以下載這些註解，再將它們納入您的「連結的自訂搜尋引擎」。如需詳細資訊，請參閱《從 Google 儲存的 CSE 轉換為連結的 CSE》。另請注意，「連結的自訂搜尋引擎」均是廣告贊助的免費 CSE；「連結的自訂搜尋引擎」機制不得用於放置 Google Site Search 的 CSE 規格。

連結的 CSE 範例

以下是一個簡單的範例，可以協助您瞭解如何使用「連結的自訂搜尋引擎」(規格位於 http://www.guha.com/cref_cse.xml)。這個 CSE 規格包含要搜尋的網站、結果網頁的外觀和風格等資訊。下方的程式碼將使用這個 CSE 規格產生一個搜尋框 (請注意「cref」參數)。

<!-- Google CSE Search Box Begins  -->
<!-- Use of this code assumes agreement with the Google Custom Search Terms of Service. -->
<!-- The terms of service are available at http://www.google.com/cse/docs/tos.html -->
<form id="cref" action="http://www.google.com/cse">
  <input type="hidden" name="cref" value="http://www.guha.com/cref_cse.xml" />
  <input type="text" name="q" size="40" />
  <input type="submit" name="sa" value="Search" />
</form>
<script type="text/javascript" src="http://www.google.com.hk/cse/brand?form=cref"></script>
<!-- Google CSE Search Box Ends -->

重要表單參數：

cref：您 CSE 規格的 URL
q: 查詢框

立即試用這個搜尋引擎！

請注意，此搜尋框可能與 CSE 規格檔案位於同一個網站上、同一個網站的多個網頁上，甚至位於不同的網站上。

使用者第一次搜尋這個查詢關鍵字時，我們會擷取並使用這個 CSE 規格處理查詢。我們也會快取您的 CSE 規格並定期重新整理，您不必在使用者每次送出查詢時處理 Google 的 CSE 規格要求。如果您的「連結的自訂搜尋引擎」規格有所變更而必須立即重新整理，請前往我們的「連結的自訂搜尋引擎」重新整理網頁，然後輸入您的 CSE 規格網址。

結果儲存在您網站上之連結的 CSE 範例

就如同標準 [自訂搜尋引擎] 一樣，您也可以使用 [連結的 CSE] 來將結果儲存在您的網站上。若要這麼做，您需要兩個程式碼片段：搜尋框的程式碼和搜尋結果的程式碼。除了下列變更之外，搜尋框程式碼看起來和上述範例類似：

<!-- Google CSE Search Box Begins  -->
<!-- Use of this code assumes agreement with the Google Custom Search Terms of Service. -->
<!-- The terms of service are available at http://www.google.com/cse/docs/tos.html -->
<form id="cref_iframe" action="http://www.guha.com/results.html">
  <input type="hidden" name="cref" value="http://www.guha.com/cref_cse.xml" />
  <input type="hidden" name="cof" value="FORID:9" />
  <input type="text" name="q" size="40" />
  <input type="submit" name="sa" value="Search" />
</form>
<script type="text/javascript" src="http://www.google.com.hk/cse/brand?form=cref_iframe"></script>
<!-- Google CSE Search Box Ends -->

重要表單參數：

動作欄位：您要用來提供結果的 URL (在此範例中我們使用 http://www.guha.com/results.html)
cref：您 CSE 規格的 URL
cof：FORID:9、FORID:10 或 FORID:11。這是用來指定您要顯示的廣告格式，詳情請參閱 CSE 規格。
q: 查詢框

您必須將此程式碼放置在上方 [動作] 欄位所指向的 URL 中要顯示搜尋結果的位置：

<div id="cse-search-results"></div>
<script type="text/javascript">
  var googleSearchIframeName = "cse-search-results";
  var googleSearchFormName = "cse-search-box";
  var googleSearchFrameWidth = 600;
  var googleSearchDomain = "www.google.com";
  var googleSearchPath = "/cse";
</script>
<script type="text/javascript" src="http://www.google.com/afsonline/show_afs_search.js"></script>

連結的 CSE 中的註釋

若要 [連結的 CSE] 有效運作，您必須如上述範例所示指定註釋。指定註釋有兩個方法：

外部註解：您可以使用 <Include> 標籤來指定註解檔案的位置。進一步瞭解外部註解檔案。我們在上個章節看到的範例使用兩個外部註解檔案：其中一個檔案儲存於伺服器，另一個則是指令碼的輸出結果。

內嵌註解：您可以將註解與 CSE 規格放在相同檔案中；建議您閱讀內嵌註解詳細資訊。上述範例有兩個內嵌註解：http://www.solarenergy.org/* 以及 http://www.solarfacts.net/*。

我們要求每個檔案的大小不得超過 3MB。如果您的註釋多於此限制，您可以將它們分割成多個檔案，然後使用 <Include> 標籤來指定這些檔案。您最多可以有 50 個檔案，但您所包含之所有檔案大小的總和必須小於 10 MB。我們希望這可讓您為每個 CSE 包含約 25 K 的註釋。如果您需要更多註釋，我們建議您使用中繼的方式，也就是說，建立多個 CSE，取得結果，然後結合這些結果並對您的使用者顯示。這個程式化的介面幾乎可讓您做任何事！