コンテキスト: プログラム可能検索エンジンの定義

このページでは、コンテキスト ファイルを使用して検索エンジンの仕様を定義する方法について説明します。

  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。ユーザー インターフェースに表示する、サポートされている言語を 1 つ指定します。言語を指定すると、その言語の検索結果が多くなりますが、他の言語の検索結果は除外されません。指定しない場合、プログラム可能検索エンジンでは en（英語）が使用されます。値が null の場合、プログラム可能検索エンジンではユーザーの言語 / 地域の言語が使用されます。
  • autocompletions。プログラム可能検索エンジンで、検索エンジンの用語集（用語集）オートコンプリートを生成するかどうかを指定します。指定できる値は true または false です。true の場合、オートコンプリートの生成に数時間かかることがあります。この値を設定した後、オートコンプリートをリクエストできるように検索ボックスのコードを変更する必要があります。更新されたコードは、コントロール パネルの [コードの取得] タブで取得できます。オートコンプリートされたクエリを表示できるのは、検索するサイト（事前定義されたウェブサイトのコレクション）のみです。
Title 必須 検索エンジンの名前です。プログラム可能検索エンジンのホームページと検索結果ページに表示されます。
Description 必須 検索エンジンの概要ページに表示される説明テキスト。
Context 必須 ラベルに関する情報を保持します。子要素 BackgroundLabels と Facet が含まれます。
BackgroundLabels 任意 サイトやページをプロモート、追加、または除外するためのラベルのコンテナ。1 つまたは複数の子 Label 要素を含みます。
Label 任意 サイトを宣伝する、またはサイトを含めるか除外するかを決定するために使用されるラベル。次の属性を持ちます。
  • name。ラベル名。
  • mode: FILTER（優先サイトを表示するか、優先するサイトのみを表示します）または ELIMINATE（サイトを除外します）。これらのラベルは必要に応じてカスタマイズできます。
LookAndFeel 必須 検索エンジンのデザインを管理します。複数の属性と子要素があり、詳しくは外観のページをご覧ください。
ImageSearchSettings 任意

画像検索を有効にするかどうかを指定します。次の属性を持ちます。

  • enable。この検索エンジンで画像検索を有効にするかどうかを指定します。指定できる値は true または false です。