通过

创建 qna

  • 项目

命名空间：microsoft.graph.search

创建新的 qna 对象。

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ❌ ❌ ❌

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。

权限类型 最低特权权限 更高特权权限
委派（工作或学校帐户） SearchConfiguration.Read.All SearchConfiguration.ReadWrite.All
委派（个人 Microsoft 帐户） 不支持。 不支持。
应用程序 SearchConfiguration.Read.All SearchConfiguration.ReadWrite.All

HTTP 请求

POST /search/qnas

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-Type application/json. 必需。

请求正文

在请求正文中，提供 qna 对象的 JSON 表示形式。

下表显示了创建 qna 时可用的属性。

属性 类型 说明
availabilityEndDateTime DateTimeOffset QnA 停止显示为搜索结果的日期和时间。 null设置为 始终可用。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。
availabilityStartDateTime DateTimeOffset QnA 开始显示为搜索结果的日期和时间。 null设置为 始终可用。 时间戳类型使用 ISO 8601 格式表示日期和时间信息，并且始终采用 UTC 格式。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。
说明 String 搜索结果中显示的答案。 继承自 searchAnswer。
displayName String 搜索结果中显示的问题。 继承自 searchAnswer。
groupIds String collection 能够查看此 QnA 的安全组列表。
keywords microsoft.graph.search.answerKeyword 触发此 QnA 的关键字显示在搜索结果中。
languageTags 字符串集合 可在其中查看此 QnA 的地理特定语言名称的列表。 每个语言标记值都遵循 {language}-{region} 模式。 例如， en-us 是在美国使用的英语。 有关可能值的列表，请参阅 支持的语言标记。
平台 microsoft.graph.devicePlatformType 集合 能够查看此 QnA 的设备和操作系统列表。 可能的值是：android、androidForWork、ios、macOS、windowsPhone81、windowsPhone81AndLater、windows10AndLater、androidWorkProfile、unknown、androidASOP、androidMobileApplicationManagement、iOSMobileApplicationManagement、unknownFutureValue。
state microsoft.graph.search.answerState QnA 的状态。 可能的值是：published、draft、excluded、unknownFutureValue。
targetedVariations microsoft.graph.search.answerVariant 集合 不同国家/地区或设备的 QnA 变体。 需要根据用户设备、国家/地区或两者向用户显示不同内容时使用。 日期和组设置适用于所有变体。
webUrl String QnA 的 URL 链接。 当用户从搜索结果中选择此 QnA 时，他们会被定向到指定的 URL。 继承自 searchAnswer。

响应

如果成功，此方法返回响应 201 Created 代码，其中包含创建的问题和答案的 ID。

示例

请求

以下示例显示了一个请求。

POST https://graph.microsoft.com/v1.0/search/qnas
Content-Type: application/json

{
  "displayName": "Global Country Holidays",
  "webUrl": "http://www.contoso.com/",
  "description": "The dates that Contoso offices will be closed to observe holidays. These dates may differ from the actual date of the holiday in cases where the holiday falls on a weekend.    <table>    <thead>    <tr>    <td><strong>2021 Dates</strong></td>    <td><strong>Holiday</strong></td>    </tr>    </thead>    <tbody>    <tr>        <td>January 1, 2021</td>        <td>New Year's Day</td>    </tr>        <tr>        <td>January 18, 2021</td>        <td>Martin Luther King Day</td>    </tr>        <tr>        <td>February 15, 2021</td>        <td>Presidents Day</td>    </tr>        <tr>        <td>May 31, 2021</td>        <td>Memorial Day</td>    </tr>        <tr>        <td>July 5, 2021</td>        <td>Independence Day</td>    </tr>        <tr>        <td>September 6, 2021</td>        <td>Labor Day</td>    </tr>        <tr>        <td>November 25, 2021 - November 26, 2021</td>        <td>Thanksgiving Day and Day after Thanksgiving</td>    </tr>    <tr>        <td>December 23, 2021 - December 24, 2021</td>        <td>Christmas Eve and Christmas Day</td>    </tr>    </tbody>    </table>",
  "keywords":  {
    "keywords": ["new years day", "martin luther king day", "presidents day", "memorial day", "independence day", "labor day", "thanksgiving", "christmas"],
    "reservedKeywords": ["holidays", "paid days off"],
    "matchSimilarKeywords": true
  },
  "availabilityStartDateTime": "2020-09-21T20:01:37Z",
  "availabilityEndDateTime": "2021-12-31T20:01:37Z",
  "languageTags": ["en-us"],
  "platforms": ["ios"],
  "state": "published"
}

响应

以下示例显示了相应的响应。

HTTP/1.1 201 Created
Location: /733b26d5-af76-4eea-ac69-1a0ce8716897
Content-Type: application/json

{
  "id": "733b26d5-af76-4eea-ac69-1a0ce8716897"
}