ポータルから Bing Custom Search インスタンスを呼び出す
警告
2020 年 10 月 30 日に、Bing Search API は Azure AI サービスから Bing Search サービスに移行されました。 このドキュメントは、参考用としてのみ提供されています。 更新されたドキュメントについては、Bing search API のドキュメントを参照してください。 Bing 検索用の新しい Azure リソースを作成する手順については、「Azure Marketplace から Bing Search リソースを作成する」を参照してください。
カスタム検索エクスペリエンスを構成した後、Bing Custom Search ポータル内でそれをテストできます。
検索クエリを作成する
Bing Custom Search ポータルにサインインした後、ご自分の検索インスタンスを選択し、 [運用] タブをクリックします。 [エンドポイント] で、API エンドポイント (たとえば、Web API) を選択します。 表示されるエンドポイントは、お使いのサブスクリプションによって決まります。
検索クエリを作成するには、エンドポイントのパラメーター値を入力します。 ポータルに表示されるパラメーターは、選択したエンドポイントに応じて変更される可能性があることに注意してください。 詳細については、Custom Search API リファレンスを参照してください。 検索インスタンスで使用するサブスクリプションを変更するには、適切なサブスクリプション キーを追加し、該当する市場または言語パラメーターを更新します。
いくつかの重要なパラメーターを次に示します。
| パラメーター | 説明 |
|---|---|
| クエリ | 検索する検索用語。 Web、Image、Video、および Autosuggest エンドポイントに対してのみ使用できます。 |
| カスタム構成 ID | 選択された Custom Search インスタンスの構成 ID。 このフィールドは読み取り専用です。 |
| Market | 結果が引き出される市場。 Web、Image、Video、および Hosted UI エンドポイントに対してのみ使用できます。 |
| サブスクリプション キー | テストに使用するサブスクリプション キー。 ドロップダウン リストからキーを選択するか、手動で入力できます。 |
[追加パラメーター] をクリックすると、次のパラメーターが表示されます。
| パラメーター | 説明 |
|---|---|
| Safe Search | 成人向けコンテンツの Web ページをフィルター処理するために使用されるフィルター。 Web、Image、Video、および Hosted UI エンドポイントに対してのみ使用できます。 Bing Custom Video Search では、moderate および strict の 2 つの値のみがサポートされます。 |
| ユーザー インターフェイスの言語 | ユーザー インターフェイス文字列に使用する言語。 たとえば、Hosted UI でイメージおよびビデオを有効にした場合、[イメージ] タブおよび [ビデオ] タブでは指定した言語が使用されます。 |
| Count | 応答で返される検索結果の数。 Web、Image、および Video エンドポイントに対してのみ使用できます。 |
| Offset | 結果を返す前にスキップする検索の数です。 Web、Image、および Video エンドポイントに対してのみ使用できます。 |
すべての必須オプションを指定した後、[呼び出し] をクリックすると、右側のウィンドウに JSON 応答が表示されます。 Hosted UI エンドポイントを選択した場合は、下側のウィンドウで検索エクスペリエンスをテストできます。
Bing Custom Search サブスクリプションを変更する
新しいインスタンスを作成しなくても、Bing Custom Search インスタンスに関連付けられているサブスクリプションを変更することができます。 API 呼び出しが新しいサブスクリプションに対して送信および課金されるようにするには、Azure portal で新しい Bing Custom Search リソースを作成します。 API 要求で、新しいサブスクリプション キーをインスタンスのカスタム構成 ID と共に使用します。