Reports API 概览

Reports API 是一种 RESTful API，可用于访问 您用户的 Google Workspace 活动。Reports API 是 Admin SDK API 的一部分。

Reports API 提供了两种类型的报告：

• 活动报告，可报告特定应用或 服务，例如 Google 云端硬盘或管理控制台。
• 使用情况报告，其中列出了由用户导致的工作区事件。
  • “客户”使用情况报告会列出网域中所有用户的事件。
  • 用户使用情况报告会列出按用户整理的事件。

下面列出了 Reports API 中使用的常用术语：

活动报告

活动报告会列出特定 Google Workspace 中的活动信息 应用或服务活动报告包括日期、时间、用户和类型 。通过 API 参考文档 包含活动报告及其所包含信息的完整列表。 以下是一些活动报告示例（按应用或服务列出）：

• 管理员活动报告 显示管理员通过管理控制台完成的活动。例如： 您可以获取管理员更改用户姓名的所有次数的列表 使用管理控制台
• Google 云端硬盘活动报告 列出网域中的用户编辑和查看云端硬盘文档的方式。对于 例如，您可以获取特定用户在云端硬盘上的活动列表。
• 登录活动报告 提供有关您账号用户何时登录和退出其 账号。例如，您可以获得一份报告，其中会包含您的 特定时间段内的所有网域。
• 移动设备活动报告 显示使用由以下设备管理的移动设备的活动： Google 移动设备管理。 例如，您可以在用户注册新设备时收到通知。
• “OAuth 令牌活动”报告 列出用户授予或撤消使用的授权令牌时的事件 由第三方网站和应用访问您可以使用 Reports API 查看 一个列表，其中列出了第三方对用户的 Google Workspace 数据的所有访问权限。

使用情况报告

使用情况报告会提供有关您网域中 Google Workspace 事件的信息。 您可以使用 API 请求有关用户的特定信息。

• 客户使用情况报告 列出您账号中详细的应用和服务活动。此用法 会按应用类型整理信息， 该应用的专用 IP 地址
• 用户使用情况报告 按您账号的用户显示活动。您可以自定义这些报告 针对特定使用情况信息进行过滤。这些使用情况信息经过整理 并包含特定于该应用的信息。
• 实体使用情况报告 列出与您账号用户在 Currents 应用。

通知

Reports API 提供的通知可让您监控事件，例如： 对资源的更改如果您正在查看某项资源并且该资源发生变化， Reports API 会向您发送通知如需详细了解如何设置 通过 Reports API 接收通知，请参阅有关 接收推送通知。

后续步骤

• 要了解 Reports API 及其运行情况，请参考快速入门 它们按编程语言列在左侧导航栏上您可以 您还可以继续浏览此部分，了解如何设置 。

• 通过 授权 部分介绍了如何使用 OAuth 2.0 访问令牌从 Google Workspace 应用和服务。

• 如需查找特定资源类型或方法的详细信息，请参阅 API 参考文档。

• 有关详情，请参阅 Admin SDK API 问题跟踪器， 该 Google Workspace 开发者博客： 和 Google Workspace 管理员帮助中心。