用于 Microsoft Teams 消息的 Microsoft Graph Export API 可用了

Posted 2021-10-26 Justin-Liu

用 Microsoft Graph Export API 导出 Microsoft Teams 内容

基于对 SaaS 应用程序的 安全和合规性 (S+C) 考虑，微软发布了 Microsoft Graph Export API 用于 Microsoft Teams 消息的导出。

组织需要管理和存档信息的能力，以满足法规和法律要求。随着客户采用 Microsoft Teams，S+C SaaS 提供商对访问 Microsoft Teams 消息和消息托管内容 (文件、图片、贴纸等) 的需求越来越大，这些内容可以以一对一或群组聊天、频道对话和团队会议的方式共享。Microsoft Graph Export API for Teams 支持为符合要求的特定用户或团队导出 Teams 消息和消息托管内容，还可以在删除消息后的 21 天内访问已删除的消息。

使用API有两种选择：一种是为 S+C 场景设计的，另一种是为除 S+C 之外的更多通用场景设计的。S+C 场景需要 E5 许可，该许可提供种子容量，在达到种子容量之前无需消耗成本即可使用 API。对于所有其他场景，没有特定的许可证要求，API 按导出的消息收费。

为什么要使用 Export API

一些由 Export API 支持的关键场景为：

1. 获取 Teams 的内容
Export API 允许应用程序导出特定团队在定义的一段时间内的所有消息。消息检索包括新的、更新的和删除的消息及其托管内容。消息将根据合规要求从所有公开和/或私人频道导出。

2. 获取受管制用户的内容
Export API 允许应用程序导出特定用户在定义的一段时间内的所有消息。用户消息检索包括新的、更新的和删除的消息及其承载的内容。消息将根据合规要求从特定用户参与的所有一对一/组聊天线程中导出。

3. 批量导出 Teams 的消息
Export API 支持每个租户的每个应用最多 200 RPS，对于应用程序支持最多 600 RPS。这些限制使合作伙伴能够检索历史内容，并能够批量导出 Teams 消息。

4. 获取用户删除的消息
用户从 Teams 客户端删除的消息可以在删除后的 21 天内使用 Export API 访问。

想要了解更多内容可以参阅 Microsoft Docs 关于 Export API 的文档。

Export API 示例

下面演示一下如何使用 Export API

示例 1：如果您已经在您的组织中启用了 Microsoft Teams，并且希望在没有任何过滤器的情况下导出用户或团队的所有 Teams 消息，请调用如下所示的API：

GET https://graph.microsoft.com/v1.0/users/{id}/chats/getAllMessages

GET https://graph.microsoft.com/v1.0/teams/{id}/channels/getAllMessages

示例 2：如果您已经在您的组织中启用了 Microsoft Teams，并希望通过指定日期时间过滤器和前50条消息来导出用户或团队的所有 Teams 消息，请调用如下所示的API：

GET https://graph.microsoft.com/v1.0/users/{id}/chats/getAllMessages?$top=50&$filter=lastModifiedDateTime gt 2020-06-04T18:03:11.591Z and lastModifiedDateTime lt 2020-06-05T21:00:09.413Z

GET https://graph.microsoft.com/v1.0/teams/{id}/channels/getAllMessages?$top=50&$filter=lastModifiedDateTime gt 2020-06-04T18:03:11.591Z and lastModifiedDateTime lt 2020-06-05T21:00:09.413Z

如何访问 Microsoft Teams Export API

Export API 需要应用程序权限和许可，然后才能使用它们。需要具备以下权限：

• Read.All：可以访问所有的一对一、群组聊天和会议聊天消息
• Read.All：允许访问所有频道消息
• Read.All：允许访问租户的用户列表

如果要请求访问 Export API，请完成此表单。