Использование API поиска (Майкрософт) для поиска вопросов и ответов

  • Статья

Вы можете использовать API поиска (Майкрософт) в Microsoft Graph для поиска вопросов и ответов (Q&As). Ресурс qna представляет Q&As в поиске (Майкрософт). Администраторы могут создавать Q&As в Центр администрирования Microsoft 365 или с помощью API создания qna.

Предостережение

Схема API поиска изменилась в бета-версии. Некоторые свойства в поисковом запросе и ответе были переименованы или удалены. Дополнительные сведения см. в разделе Предупреждение об изменении схемы об устаревании. В примерах в этом разделе показана актуальная схема.

После создания Q&As можно использовать API поиска Microsoft Graph для поиска. Для этого укажите qna в качестве значения в свойстве entityTypes в тексте поискового запроса, а затем укажите соответствующую строку запроса, как показано в следующем примере.

Пример. Поиск Q&как

Запрос

POST https://graph.microsoft.com/beta/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/beta/$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](/graph/api/resources/search-qna).
  • Комбинированный поиск с типами сущностей, не относящихся к Answer (т. е. driveItem, list) не поддерживается. Поддерживается только комбинированный поиск с другими закладками Answer entityTypes, qna и аббревиатурой.

Дальнейшие действия