Google Drive Activity API 由 DriveActivity
资源和 activity.query
方法组成,前者表示对用户 Google 云端硬盘中的对象所做的更改,后者用于检索这些更改的相关信息。
请求
应用使用 activity.query
方法请求用户的活动数据。您可以请求针对特定云端硬盘内容或某个云端硬盘文件夹下所有内容的 activity。对于给定的请求,您可以选择按时间范围或操作类型等限制条件限制响应,并且可以选择在响应中整合 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 的信息。