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 接收通知，请参阅有关 接收推送通知。

后续步骤