大网数据广告活动
Microsoft Graph 接口

将 Microsoft Graph API 与 Microsoft Teams 结合使用

· 52CE 我爱测

Microsoft Teams 是 Microsoft 365 中基于聊天的工作区,可提供对特定于团队的日历、文件、OneNote 笔记、规划器计划等对象的内置访问权限。

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 应用(而非独立应用中)使用组 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,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。