团队资源类型

命名空间: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组。
Get team 检索指定团队的属性和关系。
更新 team 更新指定团队的属性。
删除 删除团队及其关联的组。
List members conversationMember 集合 获取此团队中的成员列表。
添加成员 conversationMember 向团队中添加新成员。
批量添加成员 actionResultPart 集合 在单个请求中将多个成员添加到团队中。
获取成员 conversationMember 集合 获取团队中的成员。
获取主通道 频道 团队的常规频道。
更新成员 conversationMember 将成员更改为所有者或返回为常规成员。
删除成员 删除团队中的一个现有成员。
批量删除成员 actionResultPart 集合 在单个请求中删除 团队 中的多个成员。
存档团队 teamsAsyncOperation 将团队置于只读状态。
解档团队 teamsAsyncOperation 将团队还原到读写状态。
克隆团队 teamsAsyncOperation 复制团队及其关联的组。
列出你的团队 team 集合 列出你所属的团队。
列出关联的团队 associatedTeamInfo 集合 获取 user 与之关联的 Microsoft Teams 中的 associatedTeamInfo 对象的列表。
列出组织中的所有团队 团队 集合 列出组织中的所有团队。
获取团队照片 二进制数据 获取团队的照片(图片)。
为团队完成迁移 团队 从团队中删除迁移模式并使团队可供用户发布和阅读消息。
示例 1:列出所有频道 channel 集合 获取此 团队 中的 频道 列表或与此 团队 (传入频道) 共享的频道列表。
列出频道 频道集合 获取 团队 中的 频道列表
列出传入通道 channel 集合 获取与此 团队 共享的 频道 列表。
删除传入频道 团队删除传入频道(从团队共享的频道)。
列出团队中的应用 teamsAppInstallation 集合 列出团队中安装的应用。
将应用添加到团队 向团队添加(安装)应用程序。
获取团队中安装的应用 teamsAppInstallation 获取团队中安装的指定应用。
升级团队中安装的应用 将团队中安装的应用程序升级到最新版本。
从团队中删除应用 从团队中删除(卸载)应用。
List permission grants resourceSpecificPermissionGrant 集合 列出授予应用访问团队的权限。
在所有已加入的团队中获取开放班次 openShift 集合 获取用户是其直接成员的所有团队中的所有 openShift 对象。
跨所有已加入的团队获取班次 shift 集合 获取用户是其直接成员的所有团队中的所有 班次 对象。
在所有加入的团队中休息 timeOff 集合 获取用户是其直接成员的所有团队中的所有 timeOff 对象。

属性

属性 类型 说明
classSettings teamClassSettings 配置班级设置。 仅当团队代表班级时可用。
classification string 标签(可选)。 通常说明团队的数据或业务敏感性。 必须与租户目录中的一个预配置集匹配。
createdDateTime dateTimeOffset 创建团队的时间戳。
说明 string 组的说明(可选)。 最大长度:1,024 个字符。
discoverySettings teamDiscoverySettings 用于让他人配置团队可发现性的设置。
displayName string 团队的名称。
funSettings teamFunSettings 用于在团队中配置 Giphy、meme 和贴纸的使用的设置。
guestSettings teamGuestSettings 用于配置来宾是否可以在团队中创建、更新或删除频道的设置。
id string 团队的唯一标识符。 组的 ID 与团队相同。 此属性是只读的,继承自基实体类型。
internalId 字符串 团队在几个位置使用的唯一 ID,例如审核日志/Office 365管理活动 API
isArchived Boolean 此团队是否处于只读模式。
isMembershipLimitedToOwners 布尔值 如果设置为 true,则团队当前处于仅限所有者的团队成员身份状态,其他团队成员(如学生)无法访问。
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 集合 团队的成员和所有者。
owners user 此团队的所有者列表。 目前,在使用应用程序权限创建团队时,必须指定一个所有者。 使用用户委托的权限时, (当前用户是所有者) ,则不能指定任何所有者。 必须将所有者指定为 GUID (对象 ID) ,而不是 UPN。
operations teamsAsyncOperation 集合 在此团队中运行过或正在运行的异步操作。
photo profilePhoto 团队照片。
primaryChannel 频道 团队的常规频道。
schedule 日程安排 此团队的排班安排。
template teamsTemplate 创建此团队时所使用的模板。 请参阅可用模板
templateDefinition teamtemplatedefinition 具有特定结构和配置的团队的团队模板定义的通用表示形式。
permissionGrants resourceSpecificPermissionGrant 集合 已授予应用访问团队的权限集合。
标记 teamworkTag 集合 与团队关联的标记。

JSON 表示形式

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

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

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