英語で読む

次の方法で共有


Microsoft Search API を使用して質問と回答を検索する

Microsoft Graph の Microsoft Search API を使用して、質問と回答 (Q&As) を検索できます。 qna リソースは、Microsoft Searchの Q&As を表します。 管理者は、Microsoft 365 管理センターまたは Create qna API を使用して Q & As を作成できます。

注意事項

検索 API スキーマがベータ版で変更されました。 検索要求と応答の一部のプロパティの名前が変更または削除されました。 詳細については、「 スキーマ変更の非推奨の警告」を参照してください。 このトピックの例では、最新のスキーマを示します。

Q&As を作成したら、Microsoft Graph Search API を使用して検索できます。 これを行うには、検索要求本文の entityTypes プロパティの値としてを指定し、次の例に示すように関連するクエリ文字列を指定qnaします。

例: Q&As をSearchする

要求

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 検索では、並べ替え、集計、改ページ処理はサポートされていません。
  • 回答のないエンティティ型 (や など driveItemlist) との組み合わせ検索はサポートされていません。 他の回答エンティティ型 のブックマークqna頭字語 との組み合わせ検索のみがサポートされています。

次の手順