このページは Cloud Translation API によって翻訳されました。

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

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

概要
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`	必須	検索エンジンに関するすべての情報を含めます。次の属性があります。 <ph type="x-smartling-placeholder"> </ph> `keywords`。検索エンジンに関連付けられたキーワードのリスト（最大 100 文字）をスペースで区切って指定します。指定しない場合、プログラム可能検索エンジンは空の値を使用します。 `language`。ユーザーインターフェースに表示するサポートされている言語のいずれかを指定します。言語を指定すると、その言語での検索結果は検索結果に表示されますが、他の言語の検索結果は除外されません。指定しない場合、プログラム可能検索エンジンは `en`（英語）を使用します。この値が null の場合、プログラム可能検索エンジンはユーザーの言語 / 地域の言語を使用します。 `autocompletions`。プログラム可能検索エンジンが検索エンジン用に用語集の予測入力を生成するかどうかを示します。使用できる値は `true` または `false` です。`true` の場合、予測入力の生成に数時間かかることがあります。この値を設定したら、予測入力をリクエストするように検索ボックスのコードを変更する必要があります。更新されたコードは、コントロールパネルの [コードを取得] タブから取得できます。予測入力を使用したクエリを表示できるのは、あらかじめ決められた一連のウェブサイトである検索を含む検索エンジンのみです。
`Title`	必須	検索エンジンの名前。プログラム可能検索エンジンのホームページと検索結果ページに表示されます。
`Description`	必須	検索エンジンの概要ページに表示される説明テキスト。
`Context`	必須	ラベルに関する情報を保持します。子要素 `BackgroundLabels` と `Facet` が含まれます。
`BackgroundLabels`	省略可	サイトやページを宣伝、追加、または除外するために使用するラベルのコンテナ。1 つ以上の子 `Label` 要素を含めます。
`Label`	省略可	サイトの宣伝や、サイトの包含/除外の判断に使用されるラベルです。次の属性があります。 <ph type="x-smartling-placeholder"> </ph> `name`。ラベル名。 `mode`。`FILTER`（優先サイトを宣伝または独占的に表示）または `ELIMINATE`（サイトを除外）。これらのラベルは必要に応じてカスタマイズできます。
`LookAndFeel`	必須	検索エンジンのデザインを制御します。複数の属性と子要素があります。詳しくは、外観のページをご覧ください。
`ImageSearchSettings`	省略可	画像検索を有効にするかどうかを指定します。次の属性があります。 `enable`。この検索エンジンで画像検索を有効にするかどうかを指定します。使用できる値は `true` または `false` です。