快速入门：使用 Python 调用必应自定义搜索终结点

警告

2020 年 10 月 30 日，必应搜索 API 从 Azure AI 服务迁移到必应搜索服务。 本文档仅供参考。 有关更新的文档，请参阅必应搜索 API 文档。 关于为必应搜索创建新的 Azure 资源的说明，请参阅通过 Azure 市场创建必应搜索资源。

使用此快速入门了解如何从必应自定义搜索实例请求搜索结果。 虽然此应用程序是使用 Python 编写的，但必应自定义搜索 API 是一种 RESTful Web 服务，与大多数编程语言兼容。 该示例的源代码可在 GitHub 上获得。

先决条件

• 必应自定义搜索实例。 有关详细信息，请参阅快速入门：创建首个必应自定义搜索实例。
• Python 2.x 或 3.x。

创建 Azure 资源

通过创建以下 Azure 资源之一开始使用必应自定义搜索 API。

必应自定义搜索资源

• 在删除资源前，可通过 Azure 门户使用。
• 使用免费定价层试用该服务，稍后升级到用于生产的付费层。

多服务资源

• 在删除资源前，可通过 Azure 门户使用。
• 在多个 Azure AI 服务中对应用程序使用相同的密钥和终结点。

创建并初始化应用程序

• 在你喜欢使用的 IDE 或编辑器中创建新的 Python 文件，然后添加以下 import 语句。 为订阅密钥、自定义配置 ID 和搜索词创建变量。

  import json
  import requests
  
  subscriptionKey = "YOUR-SUBSCRIPTION-KEY"
  customConfigId = "YOUR-CUSTOM-CONFIG-ID"
  searchTerm = "microsoft"
  

发送和接收搜索请求

1. 构造请求 URL，方法是：将搜索词追加​​到 q= 查询参数后面，并将搜索实例的自定义配置 ID 追加​​到 customconfig= 参数后面。 使用与号 (&) 分隔参数。 可以为你的资源使用以下代码中的全局终结点，或者使用 Azure 门户中显示的自定义子域终结点。

   url = 'https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search?' + 'q=' + searchTerm + '&' + 'customconfig=' + customConfigId
   

2. 将请求发送到必应自定义搜索实例，并输出返回的搜索结果。

   r = requests.get(url, headers={'Ocp-Apim-Subscription-Key': subscriptionKey})
   print(r.text)
   

后续步骤

生成自定义搜索 Web 应用