ポータルから Bing Custom Search インスタンスを呼び出すCall your Bing Custom Search instance from the Portal

警告

Bing Search API は、Cognitive Services から Bing Search Services に移行されます。Bing Search APIs are moving from Cognitive Services to Bing Search Services. 2020 年 10 月 30 日 以降、Bing Search の新しいインスタンスは、こちらに記載されているプロセスに従ってプロビジョニングする必要があります。Starting October 30, 2020, any new instances of Bing Search need to be provisioned following the process documented here. Cognitive Services を使用してプロビジョニングされた Bing Search API は、次の 3 年間、または Enterprise Agreement の終わり (どちらか先に発生した方) までサポートされます。Bing Search APIs provisioned using Cognitive Services will be supported for the next three years or until the end of your Enterprise Agreement, whichever happens first. 移行手順については、Bing Search Services に関する記事を参照してください。For migration instructions, see Bing Search Services.

カスタム検索エクスペリエンスを構成した後、Bing Custom Search ポータル内でそれをテストできます。After you've configured your custom search experience, you can test it from within the Bing Custom Search portal.

Bing Custom Search ポータルのスクリーンショット

検索クエリを作成するCreate a search query

Bing Custom Search ポータルにサインインした後、ご自分の検索インスタンスを選択し、 [運用] タブをクリックします。 [エンドポイント] で、API エンドポイント (たとえば、Web API) を選択します。After you've signed into the Bing Custom Search portal, select your search instance and click the Production tab. Under Endpoints, select an API endpoint (for example, Web API). 表示されるエンドポイントは、お使いのサブスクリプションによって決まります。Your subscription determines what endpoints are shown.

検索クエリを作成するには、エンドポイントのパラメーター値を入力します。To create a search query, enter the parameter values for your endpoint. ポータルに表示されるパラメーターは、選択したエンドポイントに応じて変更される可能性があることに注意してください。Note that the parameters displayed in the portal may change depending on the endpoint you choose. 詳細については、Custom Search API リファレンスを参照してください。See the Custom Search API reference for more information. 検索インスタンスで使用するサブスクリプションを変更するには、適切なサブスクリプション キーを追加し、該当する市場または言語パラメーターを更新します。To change the subscription your search instance uses, add the appropriate subscription key, and update the appropriate market and/or language parameters.

いくつかの重要なパラメーターを次に示します。Some important parameters are below:

パラメーターParameter 説明Description
クエリQuery 検索する検索用語。The search term to search for. Web、Image、Video、および Autosuggest エンドポイントに対してのみ使用できます。Only available for Web, Image, Video, and Autosuggest endpoints
カスタム構成 IDCustom Configuration ID 選択された Custom Search インスタンスの構成 ID。The configuration ID of the selected Custom Search instance. このフィールドは読み取り専用です。This field is read only.
MarketMarket 結果が引き出される市場。The market that results will originate from. Web、Image、Video、および Hosted UI エンドポイントに対してのみ使用できます。Only available for the Web, Image, Video, and Hosted UI endpoints.
サブスクリプション キーSubscription Key テストに使用するサブスクリプション キー。The subscription key to test with. ドロップダウン リストからキーを選択するか、手動で入力できます。You can select a key from the dropdown list or enter one manually.

[追加パラメーター] をクリックすると、次のパラメーターが表示されます。Clicking Additional Parameters reveals the following parameters:

パラメーターParameter 説明Description
Safe SearchSafe Search 成人向けコンテンツの Web ページをフィルター処理するために使用されるフィルター。A filter used to filter webpages for adult content. Web、Image、Video、および Hosted UI エンドポイントに対してのみ使用できます。Only available for the Web, Image, Video, and Hosted UI endpoints. Bing Custom Video Search では、moderate および strict の 2 つの値のみがサポートされます。Note that Bing Custom Video Search only supports two values: moderate and strict.
ユーザー インターフェイスの言語User Interface Language ユーザー インターフェイス文字列に使用する言語。The language used for user interface strings. たとえば、Hosted UI でイメージおよびビデオを有効にした場合、[イメージ] タブおよび [ビデオ] タブでは指定した言語が使用されます。For example, if you enable images and videos in Hosted UI, the Image and Video tabs use the specified language.
CountCount 応答で返される検索結果の数。The number of search results to return in the response. Web、Image、および Video エンドポイントに対してのみ使用できます。Available only for Web, Image, and Video endpoints.
OffsetOffset 結果を返す前にスキップする検索の数です。The number of search results to skip before returning results. Web、Image、および Video エンドポイントに対してのみ使用できます。Available only for Web, Image, and Video endpoints.

すべての必須オプションを指定した後、[呼び出し] をクリックすると、右側のウィンドウに JSON 応答が表示されます。After you've specified all required options, click Call to view the JSON response in the right pane. Hosted UI エンドポイントを選択した場合は、下側のウィンドウで検索エクスペリエンスをテストできます。If you select the Hosted UI endpoint, you can test the search experience in the bottom pane.

Bing Custom Search サブスクリプションを変更するChange your Bing Custom Search subscription

新しいインスタンスを作成しなくても、Bing Custom Search インスタンスに関連付けられているサブスクリプションを変更することができます。You can change the subscription associated with your Bing Custom Search instance without creating a new instance. API 呼び出しが新しいサブスクリプションに対して送信および課金されるようにするには、Azure portal で新しい Bing Custom Search リソースを作成します。To have API calls sent and charged to a new subscription, create a new Bing Custom Search resource in the Azure portal. API 要求で、新しいサブスクリプション キーをインスタンスのカスタム構成 ID と共に使用します。Use the new subscription key in your API requests, along with your instance's custom configuration ID.

次のステップNext steps