创建 teamworkSection

命名空间: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

请求标头

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

请求正文

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

下表列出了创建 teamworkSection 时可设置的属性。

属性 类型 说明
displayIcon sectionDisplayIcon 为分区显示的图标。 可选。 该图标的 skinTone 属性不可设置,并且派生自用户设置。
displayName String 分区的显示名称。 必填。 最大长度为 50 个字符。 显示名称区分大小写,并且在用户的部分中必须是唯一的。 以下名称是为系统定义的部分保留的,不能使用: RecentChats、 QuickViews、 EngageCommunitiesTeamsAndChannelsMutedChatsMeetingChats。
isExpanded 布尔值 指示该部分是否在用户界面中展开。 可选。 默认值为 true。
sortType sectionSortType 节中项目的排序顺序。 可选。 默认值为 userDefinedCustomOrder。 用户定义部分的有效值为:mostRecent、、unreadThenMostRecentuserDefinedCustomOrder、unknownFutureValue、。 该 nameAlphabetical 成员对用户定义的节无效。

响应

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

可能出现以下错误。

响应代码 邮件
400 Bad Request “displayName”属性是必需的,且不得为空。
400 Bad Request “displayName”属性不得超过 50 个字符。
400 Bad Request 节显示名称包含无效的字符或格式。
400 Bad Request “id”、“createdDateTime”、“lastModifiedDateTime”、“sectionType”或“isHierarchicalViewEnabled”属性是只读的,在创建部分时不得提供。
400 Bad Request “displayIcon.contentUrl”属性不受支持,或者“displayIcon.displayName”或“displayIcon.skinTone”属性为只读且不得提供。
400 Bad Request 已达到最大节数。
409 Conflict 已存在具有此显示名称的分区。 当请求的 displayName 与现有用户定义的节或保留的系统定义的节名称之一匹配时返回 (RecentChats, QuickViews, TeamsAndChannels, MutedChatsMeetingChatsEngageCommunities ,) 。 比较区分大小写。
409 Conflict 由于并发更改,无法更新该部分。 请重试请求。

示例

请求

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

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

{
  "displayName": "Project Alpha",
  "displayIcon": {
    "iconType": "🚀"
  },
  "sortType": "mostRecent"
}

响应

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

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

HTTP/1.1 201 Created
Content-type: application/json
Location: https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/c3d4e5f6-a7b8-9012-cdef-123456789012

{
  "@odata.type": "#microsoft.graph.teamworkSection",
  "@odata.etag": "\"1742515210\"",
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "displayName": "Project Alpha",
  "displayIcon": {
    "iconType": "🚀",
    "displayName": "Rocket",
    "contentUrl": null,
    "skinTone": null
  },
  "sectionType": "userDefined",
  "sortType": "mostRecent",
  "isExpanded": true,
  "isHierarchicalViewEnabled": false,
  "createdDateTime": "2026-03-08T10:00:00Z",
  "lastModifiedDateTime": "2026-03-08T10:00:00Z"
}