团队资源类型
命名空间：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)"
}