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

返回此云端硬盘文件夹以及所有子级和后代的活动。格式为 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 中的分组规则整合活动。在一个时间范围内发生的类似操作可以分组到多个目标（例如一次移动一组文件）或多个执行者（例如多个用户编辑同一项）。此策略的分组规则特定于每种操作。