使用 Microsoft 搜索 API 搜索问题和答案
可以使用 Microsoft Graph 中的 Microsoft 搜索 API (Q&as) 搜索问题和答案。 qna 资源表示 Microsoft 搜索 中的 Q&As。 管理员可以在 Microsoft 365 管理中心或通过创建 qna API 创建 Q& As。
注意
测试版中的搜索 API 架构已更改。 搜索请求和响应中的某些属性已重命名或删除。 有关详细信息,请参阅 架构更改弃用警告。 本主题中的示例显示了最新的架构。
创建 Q&As 后,可以使用 Microsoft Graph 搜索 API 进行搜索。 为此,请在搜索请求正文的 entityTypes 属性中指定 qna
为 值,然后提供相关的查询字符串,如以下示例所示。
POST https://graph.microsoft.com/v1.0/search/query
Content-Type: application/json
{
"requests": [
{
"entityTypes": [
"qna"
],
"query": {
"queryString":"what is Microsoft Azure"
}
}
]
}
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#search",
"value": [
{
"@odata.type": "#microsoft.graph.searchResponse",
"hitsContainers": [
{
"@odata.type": "#microsoft.graph.searchHitsContainer",
"hits": [
{
"hitId": "2364ebd9-cd11-4f47-b785-fe378c6233f3",
"rank": 1,
"resource": {
"@odata.type": "#microsoft.graph.search.qna",
"id": "2364ebd9-cd11-4f47-b785-fe378c6233f3",
"displayName": "what is Microsoft Azure",
"description": "Microsoft Azure is a cloud computing platform and an online portal that allows you to access and manage cloud services and resources provided by Microsoft.",
"webUrl": "https://azure.microsoft.com/en-us/resources/cloud-computing-dictionary/what-is-azure/"
}
}
],
"total": 1,
"moreResultsAvailable": false
}
]
}
]
}
- qna 搜索不支持排序、聚合和分页。
- 例如,
driveItem
不支持将搜索与非应答实体类型组合 (和list
) 。 仅支持与其他答案实体类型 书签、 qna 和 首字母缩略词 的组合搜索。