查询 Google 云端硬盘中的过往活动记录。
HTTP 请求
POST https://driveactivity.googleapis.com/v2/activity:query
网址采用 gRPC 转码语法。
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "consolidationStrategy": { object ( |
字段 | |
---|---|
consolidationStrategy |
有关如何整合构成活动的相关操作的详细信息。如果未设置,则相关操作不会合并。 |
pageSize |
响应中所需的最小活动数;服务器尝试返回至少此数量。如果在请求超时之前服务器已准备好部分响应,那么返回的 Activity 也可能会减少。如果未设置此字段,则系统会使用默认值。 |
pageToken |
该令牌确定要返回的结果页。将此值设置为从上一个查询返回的 nextPageToken 值,以获取下一页的结果。如果未设置,则返回第一页结果。 |
filter |
针对此查询请求返回的商品的过滤。过滤器字符串的格式是一系列表达式,这些表达式由可选的“AND”连接,其中每个表达式都采用“字段运算符值”形式。 支持的字段:
|
联合字段 key 。查询中的主要条件。如果未指定键,则默认值为 ancestorName = items/root 。key 只能是下列其中一项: |
|
itemName |
返回此云端硬盘内容的活动。格式为 |
ancestorName |
返回此云端硬盘文件夹的 activity,以及所有子文件夹和后代文件夹。格式为 |
响应正文
如果成功,响应正文将包含结构如下的数据:
查询云端硬盘活动的响应消息。
JSON 表示法 |
---|
{
"activities": [
{
object ( |
字段 | |
---|---|
activities[] |
所请求的活动列表。 |
nextPageToken |
用于检索下一页结果的令牌。如果列表中没有更多结果,则为空。 |
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/drive.activity
https://www.googleapis.com/auth/drive.activity.readonly
有关详情,请参阅授权指南。
ConsolidationStrategy
如何整合各项活动。如果一组活动相关,则可以将它们合并为一个组合活动,例如一个操作者对多个目标执行相同的操作,或者多个操作者对一个目标执行相同的操作。策略定义了哪些活动相关的规则。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 strategy 。如何整合各项活动。strategy 只能是下列其中一项: |
|
none |
系统不会合并个别活动。 |
legacy |
各项活动使用旧版策略进行整合。 |
NoConsolidation
不整合各项活动的策略。
旧式
使用旧版 V1 Activity API 中的分组规则整合活动的策略。同一时间段内发生的类似操作可以分组到多个目标(例如一次移动一组文件)或多个操作者(例如,多位用户编辑同一项)中。此策略的分组规则专门针对每种类型的操作。