Method: activity.query

查询 Google 云端硬盘中的过往活动记录。

HTTP 请求

POST https://driveactivity.googleapis.com/v2/activity:query

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "consolidationStrategy": {
    object (ConsolidationStrategy)
  },
  "pageSize": integer,
  "pageToken": string,
  "filter": string,

  // Union field key can be only one of the following:
  "itemName": string,
  "ancestorName": string
  // End of list of possible types for union field key.
}
字段
consolidationStrategy

object (ConsolidationStrategy)

有关如何整合构成活动的相关操作的详细信息。如果未设置，则相关操作不会合并。
pageSize

integer

响应中所需的最小活动数；服务器尝试返回至少此数量。如果在请求超时之前服务器已准备好部分响应，那么返回的 Activity 也可能会减少。如果未设置此字段，则系统会使用默认值。
pageToken

string

该令牌确定要返回的结果页。将此值设置为从上一个查询返回的 nextPageToken 值，以获取下一页的结果。如果未设置，则返回第一页结果。
filter

string

针对此查询请求返回的商品的过滤。过滤器字符串的格式是一系列表达式，这些表达式由可选的“AND”连接，其中每个表达式都采用“字段运算符值”形式。

支持的字段：

  • time：对日期值使用数字运算符，以自 1970 年 1 月 1 日以来的毫秒数表示，或采用 RFC 3339 格式。示例：

    • time > 1452409200000 AND time <= 1492812924310
    • time >= "2016-01-10T01:02:03-05:00"

  • detail.action_detail_case：使用“包含”运算符 (:) 以及用括号括起来的单个值或允许的操作类型列表（用空格分隔）。如需将某个结果从响应中排除，请在过滤条件字符串的开头添加一个连字符 (-)。示例：

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
联合字段 key。查询中的主要条件。如果未指定键，则默认值为 ancestorName = items/root。key 只能是下列其中一项：
itemName

string

返回此云端硬盘内容的活动。格式为 items/ITEM_ID。
ancestorName

string

返回此云端硬盘文件夹的 activity，以及所有子文件夹和后代文件夹。格式为 items/ITEM_ID。

响应正文

如果成功，响应正文将包含结构如下的数据：

查询云端硬盘活动的响应消息。

JSON 表示法 
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
字段
activities[]

object (DriveActivity)

所请求的活动列表。
nextPageToken

string

用于检索下一页结果的令牌。如果列表中没有更多结果，则为空。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/drive.activity
  • https://www.googleapis.com/auth/drive.activity.readonly

有关详情，请参阅授权指南。

ConsolidationStrategy

如何整合各项活动。如果一组活动相关，则可以将它们合并为一个组合活动，例如一个操作者对多个目标执行相同的操作，或者多个操作者对一个目标执行相同的操作。策略定义了哪些活动相关的规则。

JSON 表示法 
{

  // Union field strategy can be only one of the following:
  "none": {
    object (NoConsolidation)
  },
  "legacy": {
    object (Legacy)
  }
  // End of list of possible types for union field strategy.
}
字段
联合字段 strategy。如何整合各项活动。strategy 只能是下列其中一项：
none

object (NoConsolidation)

系统不会合并个别活动。
legacy

object (Legacy)

各项活动使用旧版策略进行整合。

NoConsolidation

不整合各项活动的策略。

旧式

使用旧版 V1 Activity API 中的分组规则整合活动的策略。同一时间段内发生的类似操作可以分组到多个目标（例如一次移动一组文件）或多个操作者（例如，多位用户编辑同一项）中。此策略的分组规则专门针对每种类型的操作。