使用英语阅读

通过


使用 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 为 值,然后提供相关的查询字符串,如以下示例所示。

示例:搜索 Q&为

请求

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首字母缩略词 的组合搜索。

后续步骤