Используйте API Microsoft Поиск для поиска вопросов и ответов

  • Статья

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

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

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

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

Пример: Поиск Q&As

Запрос

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 и аббревиатура .

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