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 请求有关用户的特定信息。

  • 客户使用情况报告列出了您帐号中详细的应用和服务活动。此使用情况信息按应用类型进行组织,包含特定于该应用的信息。
  • 用户使用情况报告会显示您账号用户的活动。您可以针对特定使用情况信息自定义和过滤这些报告。这些使用情况信息按应用类型进行整理,包含特定于该应用的信息。
  • 实体使用情况报告列出了与您的帐号用户在 Currents 应用中使用的实体相关的活动。
通知
通过 Reports API 提供的通知,您可以监视事件,例如资源更改。当您查看某项资源且该资源发生更改时,Reports API 会向您发送通知。如需详细了解如何设置和接收来自 Reports API 的通知,请参阅接收推送通知指南。

后续步骤