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

希望在响应中返回的活动数量下限；服务器会尝试至少返回此数量。如果服务器在请求超时之前准备好了部分响应，则返回的活动数量也可能会减少。如果未设置，则使用默认值。
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

返回此云端硬盘文件夹以及所有子级和后代的活动。格式为 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

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

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 中的分组规则整合活动。在一个时间范围内发生的类似操作可以分组到多个目标（例如一次移动一组文件）或多个执行者（例如多个用户编辑同一项）。此策略的分组规则特定于每种操作。