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 参考文档。