クイックスタート:Python を使用して Bing Custom Search エンドポイントを呼び出す

[アーティクル]
05/08/2020

警告

2020 年 10 月 30 日に、Bing Search API は Azure AI サービスから Bing Search サービスに移行されました。このドキュメントは、参考用としてのみ提供されています。更新されたドキュメントについては、Bing search API のドキュメントを参照してください。 Bing 検索用の新しい Azure リソースを作成する手順については、「Azure Marketplace から Bing Search リソースを作成する」を参照してください。

このクイックスタートでは、Bing Custom Search インスタンスに検索結果を要求する方法を学習します。このアプリケーションは Python で記述されていますが、Bing Custom Search API はほとんどのプログラミング言語と互換性のある RESTful Web サービスです。このサンプルのソースコードは、GitHub で入手できます。

前提条件

Bing Custom Search インスタンス。詳細については、「クイックスタート: 最初の Bing Custom Search インスタンスの作成」を参照してください。
Python 2.x または 3.x。

Azure リソースを作成する

次のいずれかの Azure リソースを作成して、Bing Custom Search API の使用を開始します。

Bing Custom Search リソース

ご自身でリソースを削除するまでは Azure portal からご利用いただけます。
Free 価格レベルを使ってサービスを試用し、後から運用環境用の有料レベルにアップグレードします。

マルチサービスリソース

ご自身でリソースを削除するまでは Azure portal からご利用いただけます。
複数の Azure AI サービス全体で同じキーとエンドポイントをアプリケーションに使用します。

アプリケーションを作成して初期化する

お気に入りの IDE またはエディターで新しい Python ファイルを作成し、次の import ステートメントを追加します。サブスクリプションキー、カスタム構成 ID、および検索語句のための変数を作成します。
```
import json
import requests

subscriptionKey = "YOUR-SUBSCRIPTION-KEY"
customConfigId = "YOUR-CUSTOM-CONFIG-ID"
searchTerm = "microsoft"
```

検索要求の送信と受信

検索語句を q= クエリパラメーターに追加し、検索インスタンスのカスタム構成 ID を customconfig= パラメーターに追加して、要求 URL を作成します。パラメーターの区切りには、アンパサンド (&) を使用します。次のコードのグローバルエンドポイントか、Azure portal に表示される、対象のリソースのカスタムサブドメインエンドポイントを使用できます。
```
url = 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 'q=' + searchTerm + '&' + 'customconfig=' + customConfigId
```
対象の Bing Custom Search インスタンスに要求を送信し、返された検索結果を出力します。
```
r = requests.get(url, headers={'Ocp-Apim-Subscription-Key': subscriptionKey})
print(r.text)
```

次のステップ

Custom Search Web アプリの作成

クイック スタート:Python を使用して Bing Custom Search エンドポイントを呼び出す