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)

有关如何整合构成 activity 的相关操作的详细信息。如果未设置，则不会合并相关操作。
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：使用“has”运算符 (:)，以及单个值或用英文括号括起来的允许操作类型列表（以空格分隔）。如需从响应中排除某个结果，请在过滤条件字符串的开头添加连字符 (-)。示例：

    • 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 相关，则可以将它们整合为一个组合 activity，例如一个 actor 对多个目标执行同一操作，或多个 actor 对单个目标执行同一操作。该策略定义了哪些 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 中的分组规则来整合活动的策略。在一定时间范围内发生的类似操作可以跨多个目标（例如同时移动一组文件）或多个参与者（例如多个用户编辑同一项内容）进行分组。此策略的分组规则因每种操作类型而异。