Google Drive Activity API 简介

Google Drive Activity API 包含 DriveActivity 资源（表示对用户 Google 云端硬盘中的对象进行的更改）和 activity.query 方法（用于检索与这些更改相关的信息）。

请求

您的应用使用 activity.query 方法请求用户活动数据。您可以请求特定云端硬盘项目或云端硬盘文件夹中包含的所有内容的活动。对于给定的请求，您可以选择通过时间范围或操作类型等限制条件来限制响应，也可以选择在响应中整合活动。如需了解详情，请参阅在 Drive Activity API 中发出请求。

响应

对请求的响应是与指定参数匹配的活动列表，其中 DriveActivity 资源表示每项活动：

云端硬盘活动说明。

DriveActivity 资源是 Action 对象的集合，每个对象都像活动一样自成一体。Action 包括 ActionDetail（例如 Create 或 Edit）、Actor（例如 User 或 Administrator）、Target（例如 DriveItem 或 Drive），以及 Timestamp 或 TimeRange。

DriveActivity 资源还包含摘要信息，例如所有操作的每个 Actor 和 Target、统一的 Timestamp 或 TimeRange，以及 Action 的最重要或最具代表性的 ActionDetail。

如需了解详情，请参阅 Drive Activity API 数据模型。

活动记录的可见性

使用此 API 时，系统可能不会报告云端硬盘上的某些活动。Drive Activity API 是否会报告对对象的特定更改，取决于经过身份验证的用户是否可以在您的应用中看到相应更改或与相应更改相关的信息。

可见性取决于为对象设置的权限。在云端硬盘中共享文件和文件夹时，有以下几种情况：

  • 如果作者共享文档，则不仅创建者可以查看该文档的活动历史记录，经过身份验证的共享对象也可以查看。
  • 如果某个文档曾与用户共享，但后来设为私密，则已通过身份验证的用户可以查看其拥有访问权限期间的所有活动记录，以及权限现在受到限制。
  • 如果文档从未与用户共享，则该用户无法查看任何活动历史记录。

开始使用

如需充分利用 Drive Activity API，请先将您的应用与 Google Drive API 集成。如需开始使用 Drive Activity API，请了解如何创建项目和授权请求。或者，直接深入了解 API 参考文档中的 activity。