团队资源类型

命名空间:microsoft.graph

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

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

方法

方法 返回类型 说明
创建 teamsAsyncOperation 从头开始创建团队。
从组创建团队 team 创建新团队,或将团队添加到现有Microsoft 365组。
Get team 检索指定团队的属性和关系。
更新 team 更新指定团队的属性。
删除 删除团队及其关联的组。
List members conversationMember 集合 获取此团队中的成员列表。
添加成员 conversationMember 向团队中添加新成员。
批量添加成员 actionResultPart 集合 在单个请求中将多个成员添加到团队中。
获取成员 conversationMember 集合 获取团队中的成员。
获取主通道 频道 团队的常规频道。
更新成员 conversationMember 将成员更改为所有者或返回为常规成员。
删除成员 删除团队中的一个现有成员。
存档团队 teamsAsyncOperation 将团队置于只读状态。
解档团队 teamsAsyncOperation 将团队还原到读写状态。
克隆团队 teamsAsyncOperation 复制团队及其关联的组。
列出你的团队 team 集合 列出你属于的团队。
列出关联的团队 associatedTeamInfo 集合 获取 用户 与之关联的 Microsoft Teams 中的 团队 列表。
列出组织中的所有团队 团队 集合 列出组织中的所有团队。
为团队完成迁移 团队 从团队中删除迁移模式并使团队可供用户发布和阅读消息。
示例 1:列出所有频道 channel 集合 获取此 团队 中的 频道 列表或与此 团队 (传入频道) 共享的频道列表。
列出频道 频道集合 获取 团队 中的 频道列表
列出传入通道 channel 集合 获取传入 频道(与团队共享的频道)列表。
删除传入频道 团队删除传入频道(从团队共享的频道)。
列出团队中的应用 teamsAppInstallation 集合 列出团队中安装的应用。
将应用添加到团队 向团队添加(安装)应用程序。
获取团队中安装的应用 teamsAppInstallation 获取团队中安装的指定应用。
升级团队中安装的应用 将团队中安装的应用程序升级到最新版本。
从团队中删除应用 从团队中删除(卸载)应用。
List permission grants resourceSpecificPermissionGrant 集合 列出已授予应用访问团队的权限。

属性

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

实例属性

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

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

有关 POST 请求示例,请参阅请求(创建处于迁移状态的团队)

关系

关系 类型 Description
allChannels channel 集合 托管在团队中或与团队共享的频道列表(传入频道)。
channels channel 集合 与团队相关的频道和消息的集合。
incomingChannels channel 集合 与团队共享的 频道 列表。
installedApps teamsAppInstallation 集合 此团队中安装的应用。
members conversationMember 集合 团队的成员和所有者。
operations teamsAsyncOperation 集合 在此团队中运行过或正在运行的异步操作。
photo profilePhoto 团队的个人资料照片。
primaryChannel 频道 团队的常规频道。
schedule 日程安排 此团队的排班安排。
标记 teamworkTag 集合 与团队关联的标记。
template teamsTemplate 创建此团队时所使用的模板。 请参阅可用模板
permissionGrants resourceSpecificPermissionGrant 集合 已授予应用访问团队的权限集合。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

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

{
  "classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
  "classification": "String",
  "createdDateTime": "DateTimeOffset",
  "description": "String",
  "displayName": "String",
  "funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
  "guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
  "internalId": "String",
  "isArchived": "Boolean",
  "memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
  "messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
  "specialization": "String",
  "tenantId": "String",
  "visibility": "String",
  "webUrl": "String (URL)"
}