你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

什么是必应自动建议?

警告

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

如果应用程序向任何必应搜索 API 发送查询,可以使用必应自动建议 API 来改进用户的搜索体验。 必应自动建议 API 根据搜索框中的部分查询字符串返回建议查询的列表。 在搜索框中输入字符时,可以在下拉列表中显示建议。

必应自动建议 API 功能

Feature 说明
实时建议搜索词 通过在你键入时使用自动建议 API 显示建议的搜索词来改善应用体验。

工作流

必应自动建议 API 是一项 RESTful Web 服务,可以轻松地通过任何编程语言调用,只要该语言能够发出 HTTP 请求和分析 JSON 即可。

  1. 创建可以访问必应搜索 API 的认知服务 API 帐户。 如果没有 Azure 订阅,可以免费创建一个帐户
  2. 每次用户在应用程序的搜索框中键入新字符时,都会向此 API 发送请求。
  3. 通过分析返回的 JSON 消息处理 API 响应。

通常,每次用户在应用程序的搜索框中键入新字符时,你都会调用此 API。 输入更多字符时,API 将返回更相关的建议搜索查询。 例如,API 可能为单个 s 返回的建议可能不如为 sail 返回的建议相关。

下面的示例显示了一个下拉搜索框,其中包含 Bing 自动建议 API 提供的建议查询词。

Autosuggest drop-down search box list

当用户从下拉列表中选择建议时,你可以使用它开始通过必应搜索 API 之一进行搜索,或者直接转到必应搜索结果页。

后续步骤

若要快速了解如何使用第一个请求,请参阅创建第一个查询

使自己熟悉必应自动建议 API v7 参考文档。 此参考文档包含可以用来请求建议查询词的终结点、标头和查询参数的列表,以及响应对象的定义。

请访问必应搜索 API 中心页,浏览其他可用的 API。

了解如何使用必应 Web 搜索 API 搜索 Web,并浏览其他必应搜索 API

确保阅读必应使用和显示要求,以免违反关于搜索结果使用要求的任何规则。