reportRoot:getTeamsTeamActivityDetail
命名空间:microsoft.graph
按团队获取有关 Microsoft Teams 活动的详细信息。 这些数字包括许可和无许可用户的活动。
此 API 可用于以下国家级云部署。
全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
权限类型 | 最低特权权限 | 更高特权权限 |
---|---|---|
委派(工作或学校帐户) | Reports.Read.All | 不可用。 |
委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
应用 | Reports.Read.All | 不可用。 |
注意:要使委托权限允许应用代表用户读取服务使用情况报告,租户管理员必须向用户分配适当的Microsoft Entra ID受限管理员角色。 有关详细信息,请参阅 授权 API 读取 Microsoft 365 使用情况报告。
HTTP 请求
GET /reports/getTeamsTeamActivityDetail(period='{period_value}')
函数参数
在请求 URL 中,为以下参数提供有效值。
参数 | 类型 | 说明 |
---|---|---|
period | string | 指定在多长时间内聚合报表。 {period_value} 支持的值为: D7 、 D30 、 D90 和 D180 。 这些值采用格式 Dn,其中 n 表示在多少天内聚合报表。 必需。 |
date | Date | 指定要查看一个或多个团队中有关活动的详细信息的日期。 {date_value} 必须采用格式 YYYY-MM-DD。 因为此报表的有效期仅为过去 30 天,所以 {date_value} 应为这个范围内的日期。 |
注意: 需要在请求 URL 中设置 句点 或 日期 。
请求标头
名称 | 说明 |
---|---|
Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
响应
如果成功,此方法返回 302 Found
响应,以重定向到报表的预先验证的下载 URL。 可以在响应的 Location
头中找到此 URL。
预身份验证的下载 URL 仅在短时间内有效, (几分钟) 不需要 Authorization
标头。
CSV 文件包含下面的列标题:
- 报表刷新日期
- 工作组名称
- 团队 ID
- 团队类型
- 上次活动日期
- 报表周期
- 活动用户
- 活动通道
- 来宾
- 回应
- 已组织的会议
- 发布消息
- 回复消息
- 通道消息
- 紧急消息
- 提及
- 活动共享频道
- 活动外部用户
示例
下面是输出 CSV 的示例。
请求
以下示例显示了一个请求。
GET https://graph.microsoft.com/v1.0/reports/getTeamsTeamActivityDetail(period='D7')
响应
以下示例显示了相应的响应。
HTTP/1.1 302 Found
Content-Type: text/plain
Location: https://reports.office.com/data/download/JDFKdf2_eJXKS034dbc7e0t__XDe
遵循 302 重定向,下载的 CSV 文件具有以下架构。
HTTP/1.1 200 OK
Content-Type: application/octet-stream
Report Refresh Date,Team Name,Team Id,Team Type,Last Activity Date,Report Period,Active Users,Active Channels,Guests,Reactions,Meetings Organized,Post Messages,Reply Messages,Channel Messages,Urgent Messages,Mentions,Active Shared Channels,Active External Users
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈