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：使用“包含”运算符 (:) 以及单数值或允许使用括号括起来的允许操作列表（用空格分隔）。要从结果中排除某个结果，请在过滤器字符串的开头添加连字符 (-)。示例：

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
联合字段 key。查询中的主要条件。如果未指定键，则默认值为 祖先实体 = 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

如需了解详情，请参阅授权指南。

整合策略

如何合并各个 activity。如果一组 activity 相关，它们可以整合到一个合并的 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。如何合并各个 activity。strategy 只能是下列其中一项：
none

object (NoConsolidation)

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

object (Legacy)

使用单独策略合并各个活动。

无整合

不整合个人活动的策略。

旧式

一种策略，使用来自旧版 V1 Activity API 的分组规则来整合活动。在特定时间范围内发生的类似操作可能会归类到多个目标（例如一次移动一组文件）或多个执行者（例如多位用户编辑同一项）。此策略的分组规则特定于每种操作类型。