Bing Autosuggest とはWhat is Bing Autosuggest?

アプリケーションから Bing Search API のいずれかにクエリを送信する場合、ユーザーの検索エクスペリエンスを向上させるために Bing Autosuggest API を使用することができます。If your application sends queries to any of the Bing Search APIs, you can use the Bing Autosuggest API to improve your users' search experience. Bing Autosuggest API は、検索ボックス内の部分的なクエリ文字列に基づいて、候補となるクエリの一覧を返します。The Bing Autosuggest API returns a list of suggested queries based on the partial query string in the search box. 検索ボックスに文字を入力すると、ドロップダウン リストに候補が表示されます。As characters are entered into the search box, you can display suggestions in a drop-down list.

Bing Autosuggest API の機能Bing Autosuggest API features

機能Feature 説明Description
検索用語をリアルタイムで提案するSuggest search terms in real-time Autosuggest API を使用して、入力時に検索語句の候補を表示することで、アプリのエクスペリエンスを向上させます。Improve your app experience by using the Autosuggest API to display suggested search terms as they're typed.

ワークフローWorkflow

Bing Autosuggest API は RESTful Web サービスです。HTTP 要求を実行して JSON を解析できる任意のプログラミング言語から簡単に呼び出すことができます。The Bing Autosuggest API is a RESTful web service, easy to call from any programming language that can make HTTP requests and parse JSON.

  1. Bing Search API が利用できる Cognitive Services API アカウントを作成します。Create a Cognitive Services API account with access to the Bing Search APIs. Azure サブスクリプションをお持ちでない場合は、無料でアカウントを作成できます。If you don't have an Azure subscription, you can create an account for free.
  2. アプリケーションの検索ボックスにユーザーが新しい文字を入力するたびに、この API に要求を送信します。Send a request to this API each time a user types a new character in your application's search box.
  3. 返された JSON メッセージを解析して API 応答を処理します。Process the API response by parsing the returned JSON message.

通常は、アプリケーションの検索ボックスにユーザーが新しい文字を入力するたびに、この API を呼び出します。Typically, you'd call this API each time the user types a new character in your application's search box. 新たに文字が入力されるたびに、より関連性の高い検索クエリ候補が API から返されます。As more characters are entered, the API will return more relevant suggested search queries. たとえば、s の 1 文字について API から返される候補は、sail で返される候補よりも関連性が低くなることが考えられます。For example, the suggestions the API might return for a single s are likely to be less relevant than ones for sail.

Bing Autosuggest API からの検索語の候補を含んだドロップダウン検索ボックスの例を次に示します。The following example shows a drop-down search box with suggested query terms from the Bing Autosuggest API.

ドロップダウン検索ボックスによる自動提案リスト

ユーザーがドロップダウン リストから候補を選択したら、Bing Search API のいずれかでその候補を使用して検索を開始するか、Bing の検索結果ページに直接移動することができます。When a user selects a suggestion from the drop-down list, you can use it to begin searching with one of the Bing Search APIs, or directly go to the Bing search results page.

次のステップNext steps

実際に要求を送信してみるには、最初のクエリを実行するに関するページを参照してください。To get started quickly with your first request, see Making Your First Query.

Bing Autosuggest API v7 リファレンスを活用してください。Familiarize yourself with the Bing Autosuggest API v7 reference. このリファレンスには、クエリ用語候補を要求する際に使用するエンドポイント、ヘッダー、クエリ パラメーターの一覧と、応答オブジェクトの定義が記載されています。The reference contains the list of endpoints, headers, and query parameters that you'd use to request suggested query terms, and the definitions of the response objects.

その他の提供されている API については、Bing Search API ハブ ページをご覧ください。Visit the Bing Search API hub page to explore the other available APIs.

Bing Web Search API を使用して Web を検索し、他の Bing Search API を探す方法について説明します。Learn how to search the web by using the Bing Web Search API, and explore the otherBing Search APIs.

検索結果の使用に関するルールを逸脱しないよう、Bing の使用上および表示上の要件に関するページを必ず読んでください。Be sure to read Bing Use and Display Requirements so you don't break any of the rules about using the search results.