Microsoft Teams 是 Microsoft 365 中基于聊天的工作区,可提供对特定于团队的日历、文件、OneNote 笔记、规划器计划、排班计划等对象的内置访问权限。
Microsoft Teams 中的重要资源
| 资源 | 方法 |
|---|---|
| 团队 | 列出你的团队、列出所有团队、创建、读取、更新、删除、克隆、归档取消归档 |
| 组 | 添加成员、 移除成员、添加所有者、 移除所有者、获取文件、获取笔记本、获取计划、获取日历 |
| 频道 | 列出、创建、读取、更新、删除 |
| teamsTab | 列出、创建、读取、更新、删除 |
| teamsApp | 列出、发布、更新、移除 |
| teamsAppInstallation | 列出、安装、升级、移除 |
| chatMessage | 在频道中列出、在聊天中列出、发送、在频道中读取、在聊天中读取 |
| call | 回答, 拒绝, 重定向, 静音 取消静音, 更改屏幕共享角色, 列表参与者, 邀请参与者 |
| 日程安排 | 创建或替换、获取、共享 |
| schedulingGroup | 创建、列出、获取、替换、删除 |
| activityFeedNotification | 向聊天范围内的用户发送通知,向团队范围内的用户发送通知,向个人范围内的用户发送通知 |
| shift | 创建、列出、获取、替换、删除 |
| timeOff | 创建、列出、获取、替换、删除 |
| timeOffReason | 创建、列出、获取、替换、删除 |
Microsoft Teams 限制
Microsoft Teams 的已测试性能和容量限制将记录在 Microsoft Teams 限制和规范中。 无论是直接使用 Microsoft Teams 还是使用 Microsoft Graph API,这些限制均适用。 由于每个团队都有一个对应的组,并且每个组都是一个目录对象,因此对组数和目录对象数目(“资源”) 的限制也可以发挥作用。
频道内的文件存储在 SharePoint 中;SharePoint online 限制适用。
另请参阅 Microsoft Teams 服务限制。
用户和组
在 Microsoft Graph 中,Microsoft Teams 由组资源表示。 Microsoft Teams 和 Microsoft 365 组均可满足组协作的各种需求。 几乎所有基于组的功能都适用于 Microsoft Teams 和 Microsoft 365 组,例如组日历、文件、笔记、照片、计划等。 团队与 Microsoft 365 组之间的主要区别在于成员之间的通信模式。 团队成员的通信方式是在特定团队的上下文中进行持久聊天。 Microsoft 365 组成员通过组对话进行通信,它们是在 Outlook 的组上下文中发生的电子邮件对话。
具有团队的任何组都具有 resourceProvisioningOptions 属性,它包含“团队”。
注释: 可以更改 Group.resourceProvisioningOptions 属性。 请不要在该集合中添加或删除“团队”;否则,当你列出所有团队时,你将获得错误结果。
以下是团队和组之间的 API 级别的区别:
- 持久聊天仅适用于 Microsoft Teams。 此功能由频道和 chatMessage 资源按层次结构表示。
- 组对话仅适用于 Microsoft 365 组。 此功能由对话、conversationThread 和帖子资源按层次结构表示。
- 列出加入的团队方法仅适用于 Microsoft Teams。
- 呼叫和在线会议 API 仅适用于 Microsoft Teams。
- 另请参阅已知问题以了解这些 API。
注意:如果在 Microsoft Teams 应用(而非独立应用中)使用组 API(例如,作为 Microsoft Teams 中运行的选项卡或自动程序的一部分),请按照在 Microsoft Teams 页面中使用 Microsoft Graph 一文中的说明操作。
Microsoft Teams 中的成员身份更改
| 用例 | 谓词 | URL |
|---|---|---|
| 添加成员 | POST | /teams/{team-id}/members |
| 删除成员 | DELETE | /teams/{team-id}/members/{membership-id} |
| 更新成员角色 | PATCH | /teams/{team-id}/members/{membership-id} |
| 更新团队 | PATCH | /teams/{team-id} |
轮询要求
如果应用程序轮询查看是否更改了某资源,则此操作每天只能执行一次。 (teamsAsyncOperation 是一种例外情况,因为需要频繁对其进行轮询。)如果需要更频繁了解更改,应创建指向该资源的订阅并接收更改通知 (webhooks)。 如果找不到对所需订阅类型的支持,建议通过 Microsoft 365 开发人员平台创意论坛提供反馈。
轮询新邮件时,必须指定支持的日期范围。 有关详细信息,请参阅 get channel messages delta。
轮询是指对资源重复进行 GET 操作来了解资源是否变更。 只要同一资源未进行轮询,就可以一天多次对该资源进行 GET 操作。 例如,每次用户访问/刷新网页时都可以执行 GET /me/joinedTeams,但在每隔 30 秒执行一次的循环中执行 GET /me/joinedTeams 来刷新该网页则不可取。
未遵循这些轮询要求的应用将被视为违反了 Microsoft API 使用条款。 这可能导致额外的限制或暂停/终止使用 Microsoft API。
最近更新
了解此 API 集的最新功能和更新。
另请参阅
历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 nkramer)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
