Google Drive Activity API 简介

Google Drive Activity API 包含 DriveActivity 资源， 表示对用户 Google 云端硬盘中的对象所做的更改，而 activity.query 方法，您可以使用该方法 有关这些更改的信息。

请求

您的应用使用 activity.query 方法。您可以请求活动记录 或针对某个云端硬盘下包含的所有内容 文件夹中。对于给定请求，您可以选择通过以下方式限制响应： 限制条件，例如时间范围或操作类型 可以选择将活动整合到 响应。如需了解详情，请参阅在 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，并且 重要或代表性 的ActionDetail Action。

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

活动记录可见性

如果您使用此 API，系统可能不会报告云端硬盘上的某些活动。无论 Drive Activity API 根据对象是否 这一更改或相关信息将对 用户。

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

  • 如果有作者共享了某个文档，该文档的活动历史记录 不仅对创建者可见，还对通过身份验证的用户可见 分享对象。
  • 如果某个文档在与某个用户共享后被设为不公开，则经过身份验证的 用户可以在拥有访问权限时查看所有活动记录，并且权限现在 受限。
  • 如果文档从未与用户共享，则该用户无法查看任何活动 历史记录。

开始使用

要充分利用 Drive Activity API，请将您的应用与 Google Drive API。如需开始使用 Drive Activity API，请按以下步骤操作： 了解如何创建项目和 向请求授权。或者，您也可以直接阅读 活动 API 参考文档。