reportRoot: getOffice365ActivationsUserCounts
命名空间:microsoft.graph
获取在桌面、设备或共享计算机上启用了 Office订阅的用户数。
注意: 有关不同报表视图和名称的详细信息,请参阅Microsoft 365 报表 - Microsoft Office激活。
权限
要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限。
| 权限类型 | 权限(从最低特权到最高特权) |
|---|---|
| 委派(工作或学校帐户) | Reports.Read.All |
| 委派(个人 Microsoft 帐户) | 不支持。 |
| 应用 | Reports.Read.All |
注意:若要获得委派权限以允许应用代表用户读取服务使用情况报告,租户管理员必须事先为用户分配适当的 Azure AD 受限管理员角色。有关更多详细信息,请参阅 API 授权,读取 Microsoft 365使用情况报告。
HTTP 请求
GET /reports/getOffice365ActivationsUserCounts
请求标头
| 名称 | 说明 |
|---|---|
| Authorization | 持有者{令牌}。必需。 |
| If-None-Match | 如果包含此请求表头,且提供的 eTag 与文件中的当前标记一致,返回的是 304 Not Modified 响应代码。可选。 |
响应
如果成功,此方法返回 302 Found 响应,以重定向到报表的预先验证的下载 URL。 可以在响应的 Location 头中找到此 URL。
预先验证的下载 URL 的有效时间很短(几分钟),不需要 Authorization 头。
CSV 文件包含下面的列标题。
- 报表刷新日期
- 产品类型
- 已分配
- 已激活
- 共享计算机激活
示例
请求
下面展示了示例请求。
GET https://graph.microsoft.com/v1.0/reports/getOffice365ActivationsUserCounts
响应
下面展示了示例响应。
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,Product Type,Assigned,Activated,Shared Computer Activation
反馈
提交和查看相关反馈