团队资源类型

命名空间:microsoft.graph

重要

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

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 集合 列出你属于的团队。
列出关联的团队 associatedTeamInfo 集合 获取与用户关联的Microsoft Teams中关联的TeamInfo 对象的列表。
列出组织中的所有团队 团队 集合 列出组织中的所有团队。
获取团队照片 二进制数据 获取团队的照片(图片)。
完成迁移 团队 从团队中删除迁移模式并使团队可供用户发布和阅读消息。
列出所有通道 channel 集合 获取此 团队 中的 频道列表或与此 团队 共享 (传入频道) 。
列出频道 频道集合 获取 团队 中的 频道列表。
列出传入通道 channel 集合 获取与此 团队 共享的 频道列表。
删除传入通道 删除传入通道。
列出团队中安装的应用 teamsAppInstallation 集合 列出团队中安装的应用。
将应用添加到团队 向团队添加(安装)应用程序。
获取团队中安装的应用 teamsAppInstallation 获取团队中安装的指定应用。
升级团队中安装的应用 将团队中安装的应用程序升级到最新版本。
从团队中删除应用 从团队中删除(卸载)应用。
List permission grants resourceSpecificPermissionGrant 集合 列出已授予应用访问团队的权限。

属性

属性 类型 说明
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 用于配置团队中的消息传递和提及的设置。
discoverySettings teamDiscoverySettings 用于让他人配置团队可发现性的设置。
webUrl string (readonly) 用于转到 Microsoft Teams 客户端中团队的超链接。 这是在 Microsoft Teams 客户端中右键单击团队并选择 获取团队链接 时获取的 URL。 应将此 URL 视为不透明的 blob,而不对其进行解析。
classSettings teamClassSettings 配置班级设置。 仅当团队代表班级时可用。
isMembershipLimitedToOwners 布尔值 如果设置为“true”,则团队当前处于“仅所有者”团队成员身份状态,且其他团队成员(如学生)不可访问。
createdDateTime dateTimeOffset 创建团队的时间戳。
摘要 teamSummary 包含有关团队的摘要信息,包括所有者、成员和来宾的数量。
tenantId string Azure Active Directory租户的 ID。

实例属性

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

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

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

关系

关系 类型 说明
allChannels channel 集合 托管在团队中或与团队共享的频道列表 (传入频道) 。
channels channel 集合 与团队相关的频道和消息的集合。
installedApps teamsAppInstallation 集合 此团队中安装的应用。
members conversationMember 集合 团队的成员和所有者。
owners user 此团队的所有者列表。 目前,在使用应用程序权限创建团队时,必须指定一个所有者。 当使用用户委派的权限时,不能指定任何所有者(当前用户是所有者)。 必须将所有者指定为对象 ID (GUID),而不是 UPN。
operations teamsAsyncOperation 集合 在此团队中运行过或正在运行的异步操作。
photo profilePhoto 团队照片。
primaryChannel 频道 团队的常规频道。
schedule 日程安排 此团队的排班安排。
template teamsTemplate 从中创建此团队的模板。请参阅可用模板
permissionGrants resourceSpecificPermissionGrant 集合 已授予应用访问团队的权限集合。
标记 teamworkTag 集合 与团队关联的标记。

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"},
  "discoverySettings": {"@odata.type": "microsoft.graph.teamDiscoverySettings"},
  "internalId": "string",
  "isArchived": false,
  "webUrl": "string (URL)",
  "displayName": "string",
  "description": "string",
  "classification": "string",
  "specialization": "string",
  "visibility": "string",
  "classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
  "isMembershipLimitedToOwners":"boolean",
  "createdDateTime": "dateTimeOffset",
  "summary":  {"@odata.type": "microsoft.graph.teamSummary"}
}

另请参阅