搜索指定网站内容(微软AZURE全球版技术文档网站搜索API将从认知服务迁移到必应搜索)

　　搜索指定网站内容(微软AZURE全球版技术文档网站搜索API将从认知服务迁移到必应搜索)

　　您正在访问Microsoft azure全局技术文档网站。如果您需要访问由21vianet运营的Microsoft azure中国技术文档网站，请访问

　　筛选搜索响应中收录的结果

　　警告

　　Bing搜索API将从认知服务迁移到Bing搜索服务。从2020年10月30日起，Bing搜索的任何新实例都需要根据此处描述的流程进行预配置。使用认知服务预配置的Bing搜索API将在未来三年内或企业协议结束前（以先到者为准）得到支持。有关迁移说明，请参阅Bing搜索服务

　　在查询web时，Bing会返回它为搜索找到的所有相关内容。例如，如果搜索查询为“帆船+小船”，则响应可能收录以下结果：

　　{

"_type" : "SearchResponse",

"webPages" : {

"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43C...",

"totalEstimatedMatches" : 262000,

"value" : [...]

},

"images" : {

"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images",

"readLink" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?q=sail...",

"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43CA5CA6464E5D...",

"isFamilyFriendly" : true,

"value" : [...]

},

"rankingResponse" : {

"mainline" : {

"items" : [...]

}

}

}

　　查询参数

　　要过滤Bing返回的结果，请在调用API时使用以下查询参数

　　响应滤波器

　　您可以使用查询参数（以逗号分隔的结果列表）过滤Bing在响应中提供的结果类型（例如，图像、视频和新闻）。如果Bing发现了什么，响应将收录结果

　　要从响应中排除特定结果（如图像），请在结果类型之前添加-字符。例如：

　　&responseFilter=-images,-videos

　　下面显示如何使用responsefilter请求“帆船”的图像、视频和新闻。对查询字符串进行编码时，逗号更改为%2C

　　GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&responseFilter=images%2Cvideos%2Cnews&mkt=en-us HTTP/1.1

Ocp-Apim-Subscription-Key: 123456789ABCDE

User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)

X-Search-ClientIP: 999.999.999.999

X-Search-Location: 47.60357;long:-122.3295;re:100

X-MSEdge-ClientID:

Host: api.cognitive.microsoft.com

　　下面显示对上一个查询的响应。因为Bing没有找到相关的视频和新闻结果，所以他们没有被包括在回复中

　　{

"_type" : "SearchResponse",

"images" : {

"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images",

"readLink" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/images\/search?q=sail...",

"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3AD78B183C56456C...",

"isFamilyFriendly" : true,

"value" : [...]

},

"rankingResponse" : {

"mainline" : {

"items" : [{

"answerType" : "Images",

"value" : {

"id" : "https:\/\/api.cognitive.microsoft.com\/api\/v7\/#Images"

}

}]

}

}

}

　　虽然Bing在之前的回复中没有返回视频和新闻结果，但这并不意味着这些视频和新闻内容不存在。这仅表示页面不收录。但是，如果翻页浏览更多结果，这些内容可能会收录在后续页面中。此外，如果直接调用视频搜索API和新闻搜索API端点，则结果可能会收录在响应中

　　不建议使用responsefilter从单个API获取结果。如果您需要来自单个Bing API的内容，可以直接调用该API。例如，如果只希望接收图像，可以向图像搜索API端点或其他端点发送请求。调用单个API很重要，这不仅是出于性能原因，还因为特定于内容的API提供了更丰富的结果。例如，可以使用不适用于Web搜索API的筛选器筛选结果

　　场地

　　要从特定域获取搜索结果，请在查询字符串中收录site:query参数

　　https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies+site:contososailing.com&mkt=en-us

　　评论

　　如果使用site:query操作符，则仍然可以在响应中收录*敏*感*词*内容，而不管设置如何，具体取决于查询。站点：仅当网站内容已知且方案允许使用*敏*感*词*内容时才应使用

　　新鲜度

　　要将Web响应结果限制为必须在特定时间段内发现的页面，请将查询参数设置为以下值之一（不区分大小写）：

　　您还可以将此参数设置为yyyy-mm-dd格式的用户定义日期范围。。年月日

　　/必应/v7.0/search？q=ipad+更新和新鲜度=2019-02-01..2019-05-30

　　要将结果限制为单个日期，请将freshness参数设置为特定日期：

　　/必应/v7.0/search？q=ipad+更新和新鲜度=2019-02-04

　　如果Bing满足筛选条件的页面数小于您请求的页面数（或Bing返回的默认页面数），则结果可能包括指定时间段以外的页面

　　限制响应中检索结果的数量

　　Bing可以在JSON响应中返回多个结果类型。例如，如果您查询“销售+小艇”，必应可能会返回网页、图像、视频和相关搜索

　　{

"_type" : "SearchResponse",

"queryContext" : {

"originalQuery" : "sailing dinghies"

},

"webPages" : {...},

"images" : {...},

"relatedSearches" : {...},

"videos" : {...},

"rankingResponse" : {...}

}

　　要将Bing返回的搜索结果限制为前两个结果（网页和图片），请将查询参数设置为2

　　GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&answerCount=2&mkt=en-us HTTP/1.1

Ocp-Apim-Subscription-Key: 123456789ABCDE

User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)

X-Search-ClientIP: 999.999.999.999

X-Search-Location: 47.60357;long:-122.3295;re:100

X-MSEdge-ClientID:

Host: api.cognitive.microsoft.com

　　响应仅包括网页和图像

　　{

"_type" : "SearchResponse",

"queryContext" : {

"originalQuery" : "sailing dinghies"

},

"webPages" : {...},

"images" : {...},

"rankingResponse" : {...}

}

　　如果将responsefilter查询参数添加到上一个查询中，并将其设置为web pages and news，则响应中将只收录web pages，因为该新闻没有排名

　　{

"_type" : "SearchResponse",

"queryContext" : {

"originalQuery" : "sailing dinghies"

},

"webPages" : {...},

"rankingResponse" : {...}

}

　　推广非排名搜索结果

　　如果必应为查询返回的首选搜索结果是网页、图片、视频和相关搜索，则这些结果将收录在响应中。如果设置为两个（2)），必应将返回前两个搜索结果：网页和图片。如果希望Bing在其响应中收录图片和视频，请指定查询参数并将其设置为图片和视频

　　GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&answerCount=2&promote=images%2Cvideos&mkt=en-us HTTP/1.1

Ocp-Apim-Subscription-Key: 123456789ABCDE

User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)

X-Search-ClientIP: 999.999.999.999

X-Search-Location: 47.60357;long:-122.3295;re:100

X-MSEdge-ClientID:

Host: api.cognitive.microsoft.com

　　以下是对上述请求的答复。Bing返回前两个搜索结果（网页和图片），并将视频升级到搜索结果中

　　{

"_type" : "SearchResponse",

"queryContext" : {

"originalQuery" : "sailiing dinghies"

},

"webPages" : {...},

"images" : {...},

"videos" : {...},

"rankingResponse" : {...}

}

　　如果“升级”设置为“新闻”，则响应将不收录新闻搜索结果，因为它不是排名搜索结果-只能升级排名搜索结果

　　要提升的搜索结果不包括在answercount限制中。例如，如果排名的搜索结果收录新闻、图片和视频，并且answercount设置为1，promote设置为news，则响应将收录新闻和图片。或者，如果排名的搜索结果收录视频、图像和新闻，则响应将收录视频和新闻

　　仅当指定了answercount查询参数时才能使用升级

　　这一页有用吗

　　是否

　　多谢各位

　　主题