添加 teamworkSectionItem

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

将聊天、频道、会议或社区等项添加到用户团队合作中的用户定义部分。 一个项目一次只能属于一个分区。 如果项位于不同的用户定义的部分中,则此请求会将其移动到目标部分。 如果项已在目标部分中,则请求无需进行更改即可成功。

API 可用性

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

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

权限

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

权限类型 最低特权权限 更高特权权限
委派(工作或学校帐户) TeamworkSection.ReadWrite 不可用。
委派(个人 Microsoft 帐户) 不支持。 不支持。
应用程序 TeamworkSection.ReadWrite.All Teamwork.Migrate.All

HTTP 请求

POST /users/{user-id}/teamwork/sections/{teamworkSection-id}/items

请求标头

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

请求正文

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

下表列出了添加 teamworkSectionItem 时可设置的属性。

属性 类型 说明
id String 要添加到部分的聊天、频道、会议或社区的对话 ID。 对于Viva Engage) 项 (社区,可以提供 列出社区 时返回的空社区 ID (例如, eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTAzMzYyMTIyMTAifQ) 或完整 19:{communityId}@EngageCommunity 线程 ID。 提供裸社区 ID 时,服务会自动将其规范化为格式 19:{communityId}@EngageCommunity ;已包含线程前缀的 ID 将按原样使用。 必填。

响应

如果成功,此方法将在响应正文中返回 201 Created 响应代码和 teamworkSectionItem 对象。

可能出现以下错误。

响应代码 邮件
400 Bad Request “id”属性是必需的,不得为空。
400 Bad Request 指定的项 ID 无效。 提供有效的聊天、频道、会议或社区 ID。
400 Bad Request 已达到此部分中的最大项目数。
403 Forbidden 拒绝对此资源的访问。 调用方必须是所添加对话的成员。
404 Not Found 未找到指定的部分。
409 Conflict 由于并发更改,无法更新该部分。 请重试请求。

示例

示例 1:向分区添加聊天

以下示例演示如何向分区添加聊天。

请求

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

POST https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items
Content-type: application/json

{
  "id": "19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2"
}

响应

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

注意:为了提高可读性,可能缩短了此处显示的响应对象。

HTTP/1.1 201 Created
Content-type: application/json
Location: https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items/19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2

{
  "@odata.type": "#microsoft.graph.teamworkSectionItem",
  "@odata.etag": "\"1742515210\"",
  "id": "19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2",
  "itemType": "chat",
  "createdDateTime": "2026-03-08T10:00:00Z",
  "lastModifiedDateTime": null
}

示例 2:向分区添加社区

以下示例演示如何将 Viva Engage 社区添加到部分。 请求提供 列出社区时返回的裸社区 ID。 该服务将社区 ID 规范化为响应中返回的 19:{communityId}@EngageCommunity 格式。

请求

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

POST https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items
Content-type: application/json

{
  "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTAzMzYyMTIyMTAifQ"
}

响应

以下示例显示了相应的响应。 ID 属性以标准化19:{communityId}@EngageCommunity格式返回。

注意:为了提高可读性,可能缩短了此处显示的响应对象。

HTTP/1.1 201 Created
Content-type: application/json
Location: https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items/19:eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTAzMzYyMTIyMTAifQ@EngageCommunity

{
  "@odata.type": "#microsoft.graph.teamworkSectionItem",
  "@odata.etag": "\"1742515220\"",
  "id": "19:eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTAzMzYyMTIyMTAifQ@EngageCommunity",
  "itemType": "community",
  "createdDateTime": "2026-03-08T10:05:00Z",
  "lastModifiedDateTime": null
}