Google Drive Activity API 包含 DriveActivity 资源（表示对用户 Google 云端硬盘中的对象所做的更改）和 activity.query 方法（用于检索这些更改的相关信息）。
请求
您的应用使用 activity.query 方法请求用户的活动数据。您可以请求特定云端硬盘内容或某个云端硬盘文件夹下包含的所有内容的 activity。对于给定的请求，您可以选择按时间范围或操作类型等限制条件限制响应，并且可以选择整合响应中的活动。如需了解详情，请参阅在 Drive Activity API 中发出请求。
响应
对请求的响应是与指定参数匹配的 activity 列表，其中 DriveActivity 资源表示每个 activity：
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 并查看相关信息。