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

建议查询词

警告

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

通常,每次用户在应用程序的搜索框中键入新字符时,你都会调用必应自动建议 API。 查询字符串的完整性会影响 API 返回的建议查询词的相关性。 查询字符串越完整,建议的查询词列表就越相关。 例如,API 可能会为 s 返回的建议可能不如它为 sailing dinghies 返回的查询相关。

示例请求

以下示例显示了一个请求,该请求针对 sail 返回建议的查询字符串。 在设置 q 查询参数时,请记得对用户的部分查询词进行 URL 编码。 例如,如果用户输入了 sailing les,请将 q 设置为 sailing+lessailing%20les

GET https://api.cognitive.microsoft.com/bing/v7.0/suggestions?q=sail&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com

以下响应列出了包含建议查询词的 SearchAction 对象。

{
    "url" : "https:\/\/www.bing.com\/search?q=sailing+lessons+seattle&FORM=USBAPI",
    "displayText" : "sailing lessons seattle",
    "query" : "sailing lessons seattle",
    "searchKind" : "WebSearch"
}, ...

使用建议查询词

每个建议都包括 displayTextqueryurl 字段。 displayText 字段包含用于填充搜索框下拉列表的建议查询。 必须按给定的顺序显示响应包含的所有建议。

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

Autosuggest drop-down search box list

如果用户从下拉列表中选择了一个建议的查询,则你将使用 query 字段中的查询词来调用必应 Web 搜索 API 并自行显示结果。 或者,可以使用 url 字段中的 URL 将用户发送到必应搜索结果页。

后续步骤