反馈 编辑

团队资源类型

  • 项目

命名空间：microsoft.graph

Microsoft Teams 中的团队是 channel 对象的集合。 频道表示团队内部的某个主题，因此是讨论的逻辑隔离。

每个团队都与 Microsoft 365组关联。 该组具有与团队相同的 ID，例如 /groups/{id}/team 与 /teams/{id} 相同。 有关使用组和团队内部成员的详细信息，请参阅使用 Microsoft Graph REST API 来处理 Microsoft Teams。

方法

方法 返回类型 说明
创建团队 teamsAsyncOperation 从头开始创建团队。
从组创建团队 team 创建新团队，或将团队添加到现有Microsoft 365组。
获取团队 team 检索指定团队的属性和关系。
更新团队 team 更新指定团队的属性。
删除团队 无 删除团队及其关联的组。
List members conversationMember 集合 获取此团队中的成员列表。
添加成员 conversationMember 向团队中添加新成员。
批量添加成员 actionResultPart 集合 在单个请求中将多个成员添加到团队中。
获取成员 conversationMember 集合 获取团队中的成员。
更新成员角色 conversationMember 将成员更改为所有者或返回为常规成员。
删除成员 无 删除团队中的一个现有成员。
存档团队 teamsAsyncOperation 将团队置于只读状态。
解档团队 teamsAsyncOperation 将团队还原到读写状态。
克隆团队 teamsAsyncOperation 复制团队及其关联的组。
列出你的团队 team 集合 列出你属于的团队。
完成迁移 团队 从团队中删除迁移模式并使团队可供用户发布和阅读消息。
列出团队中安装的应用 teamsAppInstallation 集合 列出团队中安装的应用。
将应用添加到团队 无 向团队添加（安装）应用程序。
获取团队中安装的应用 teamsAppInstallation 获取团队中安装的指定应用。
升级团队中安装的应用 无 将团队中安装的应用程序升级到最新版本。
从团队中删除应用 无 从团队中删除（卸载）应用。

属性

属性 类型 说明
displayName string 团队的名称。
description string 组的说明（可选）。 最大长度：1024 个字符。
classification string 标签（可选）。 通常说明团队的数据或业务敏感性。 必须与租户目录中的一个预配置集匹配。
specialization teamSpecialization 可选。 指示团队是否适用于特定用例。 每个团队专用化都可以访问针对其用例的独特行为和体验。
visibility teamVisibilityType 组和团队的可见性。默认值为 Public。
funSettings teamFunSettings 用于配置团队中 Giphy、成员和贴纸使用情况的设置。
guestSettings teamGuestSettings 用于配置来宾是否可以在团队中创建、更新或删除频道的设置。
internalId 字符串 已在一些位置（如审核日志/Office 365 管理活动 API）使用的团队唯一 ID。
isArchived Boolean 此团队是否处于只读模式。
memberSettings teamMemberSettings 用于配置成员是否可以在团队中执行某些操作（例如，创建频道和添加机器人）的设置。
messagingSettings teamMessagingSettings 用于配置团队中的消息传递和提及的设置。
webUrl string (readonly) 用于转到 Microsoft Teams 客户端中团队的超链接。 这是在 Microsoft Teams 客户端中右键单击团队并选择 获取团队链接 时获取的 URL。 应将此 URL 视为不透明的 blob，而不对其进行解析。
createdDateTime dateTimeOffset 创建团队的时间戳。

实例属性

实例属性是具有特殊行为的属性。这些属性是临时的，并且 a) 定义服务应执行的行为或 b) 提供短期的属性值，例如过期项目的下载 URL。

属性名称 类型 说明
@microsoft. graph teamCreationMode string 指示团队处于迁移状态，并且当前正用于迁移目的。 它接受一个值：migration。 注意：将来，Microsoft 可能会要求你或你的客户根据导入的数据量支付其他费用。

有关 POST 请求示例，请参阅请求（创建处于迁移状态的团队）。

关系

关系 类型 说明
channels channel 集合 与团队相关的频道和消息的集合。
installedApps teamsAppInstallation 集合 此团队中安装的应用。
members conversationMember 集合 团队的成员和所有者。
operations teamsAsyncOperation 集合 在此团队中运行过或正在运行的异步操作。
primaryChannel 频道 团队的常规频道。
schedule 日程安排 此团队的排班安排。
photo profilePhoto 团队的个人资料照片。
template teamsTemplate 从中创建此团队的模板。请参阅可用模板。

JSON 表示形式

下面是资源的 JSON 表示形式。

注意： 如果团队属于班级类型，则会在团队上应用 classSettings 属性。

{
  "guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
  "memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
  "messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
  "funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
  "internalId": "string",
  "isArchived": false,
  "webUrl": "string (URL)",
  "classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
  "createdDateTime": "dateTimeOffset"
}

另请参阅