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(例如 为 DriveItemDrive),并且 Timestamp。 或 TimeRange

DriveActivity 资源还包含 比如每个 ActorTarget,统一 TimestampTimeRange,并且 重要或代表性 的ActionDetail Action

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

活动记录可见性

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

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

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

开始使用

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