Method: activities.list

string

表示要过滤数据的个人资料 ID 或用户电子邮件地址。可以是 all（表示所有信息）；userKey（表示用户的唯一 Google Workspace 个人资料 ID 或其主电子邮件地址）。不得是已删除的用户。对于已删除的用户，请使用 showDeleted=true 在 Directory API 中调用 users.list，然后将返回的 ID 用作 userKey。

enum (ApplicationName)

要检索事件的应用名称。

string

举办事件的主机的互联网协议 (IP) 地址。这也是一种使用被报告用户的 IP 地址过滤报告摘要的另一种方法。该 IP 地址不一定能反映用户的实际位置。例如，IP 地址可以是用户的代理服务器地址，也可以是虚拟专用网 (VPN) 地址。此参数支持 IPv4 和 IPv6 地址版本。

string

要为其提取数据的客户的唯一 ID。

string

设置报告中显示的时间范围的结束时间。日期采用 RFC 3339 格式，例如 2010-10-28T10:26:35.000Z。默认值为 API 请求的大致时间。API 报告有三个基本的时间概念：

• API 请求报告的日期：API 创建和检索报告的时间。
• 报表开始时间：报表中显示的时间范围的开始时间。startTime 必须在 endTime（如果已指定）和发出请求的当前时间之前，否则 API 会返回错误。
• 报表的结束时间：报表中显示的时间范围的结束时间。例如，报告中汇总的事件时间范围从 4 月开始，到 5 月结束。用户可在 8 月请求获取此报告。

string

API 所查询事件的名称。每个 eventName 都与特定的 Google Workspace 服务或功能相关，该 API 按事件类型整理这些服务或功能。例如，在管理控制台应用的报告中查看 Google 日历活动。日历设置 type 结构包含 API 报告的所有 Google 日历 eventName 活动。如果管理员更改日历设置，该 API 在日历设置 type 和 eventName 参数中报告此活动。如需详细了解 eventName 查询字符串和参数，请参阅上述 applicationName 中各种应用的事件名称列表。

string

filters 查询字符串是一个逗号分隔列表，其中包含由关系运算符操控的事件参数。事件参数的格式为 {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...

这些事件参数与特定的 eventName 相关联。如果请求的参数不属于 eventName，则返回空报告。如需详细了解每个应用的可用 eventName 字段及其相关参数，请前往 ApplicationName 表，然后点击进入“附录”中与所需应用对应的“Activity Events”页面。

在以下云端硬盘活动示例中，返回的列表包含所有 edit 事件，其中 doc_id 参数值与关系运算符定义的条件匹配。在第一个示例中，请求会返回 doc_id 值等于 12345 的所有已编辑文档。在第二个示例中，报告会返回 doc_id 值不等于 98765 的所有已修改文档。<> 运算符在请求的查询字符串 (%3C%3E) 中进行了网址编码：

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

filters 查询支持以下关系运算符：

• == -“等于”。
• <> -“不等于”。必须经过网址编码 (%3C%3E)。
• < -“小于”。必须经过网址编码 (%3C)。
• <=—“小于或等于”。必须经过网址编码 (%3C=)。
• > -“大于”。必须经过网址编码 (%3E)。
• >=—“大于或等于”。必须经过网址编码 (%3E=)。

注意：该 API 不接受同一参数的多个值。如果 API 请求中多次提供了某个参数，则 API 仅接受该参数的最后一个值。此外，如果在 API 请求中提供了无效参数，则 API 会忽略该参数，并返回与其余有效参数对应的响应。如果未请求任何参数，则返回所有参数。

integer

确定每个响应页面上显示的活动记录数量。例如，如果请求设置 maxResults=1 且报表包含两个活动，则该报表包含两个页面。响应的 nextPageToken 属性具有第二页的令牌。maxResults 查询字符串在请求中是可选的。默认值为 1000。

string

要为其生成报告的组织部门的 ID。只有属于指定组织部门的用户才会显示活动记录。

string

用于指定下一页的令牌。包含多个网页的报告会在响应中包含一个 nextPageToken 属性。在您获取报告的下一页的后续请求中，在 pageToken 查询字符串中输入 nextPageToken 值。

string

设置报告中显示的时间范围的开始时间。日期采用 RFC 3339 格式，例如 2010-10-28T10:26:35.000Z。该报告会返回从 startTime 至 endTime 的所有活动。startTime 必须在 endTime（如果已指定）和发出请求的当前时间之前，否则 API 会返回错误。

string

以逗号分隔的群组 ID（经过混淆处理），用于过滤用户活动，即响应将仅包含属于此处提及的至少一个群组 ID 的用户的活动。格式：“id:abc123,id:xyz456”

{
  "kind": string,
  "etag": string,
  "ownerDomain": string,
  "ipAddress": string,
  "events": [
    {
      "type": string,
      "name": string,
      "parameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string
  }
}

string

API 资源的类型。对于活动报告，该值为 audit#activity。

string

条目的 ETag。

string

这是指受报告事件影响的网域。例如管理控制台的网域或云端硬盘应用的文档所有者。

string

执行操作的用户的 IP 地址。这是用户登录 Google Workspace 时使用的互联网协议 (IP) 地址，不一定能反映用户的实际位置。例如，IP 地址可以是用户的代理服务器地址，也可以是虚拟专用网 (VPN) 地址。该 API 支持 IPv4 和 IPv6。

object

报告中的活动事件。

string

事件类型。type 属性用于标识管理员更改的 Google Workspace 服务或功能，此属性使用 eventName 属性标识事件。如需查看该 API 的 type 类别的完整列表，请参阅上述 applicationName 中各种应用的事件名称列表。

string

事件名称。这是 API 所报告活动的具体名称。每个 eventName 都与特定的 Google Workspace 服务或功能相关，API 按事件类型整理了相应服务或功能。
适用于一般的 eventName 请求参数：

• 如果未指定 eventName，报告会返回 eventName 的所有可能实例。
• 当您请求 eventName 时，该 API 的响应会返回包含该 eventName 的所有 activity。

object

各种应用的参数值对。如需详细了解 eventName 参数，请参阅 applicationName 中上述各种应用的事件名称列表。

object

与此参数关联的嵌套参数值对。参数的复杂值类型会以参数值列表的形式返回。例如，地址参数的值可能为 [{parameter: [{name: city, value: abc}]}]

object (NestedParameter)

参数值

string

参数的名称。

string

参数的字符串值。

string

参数的字符串值。

string (int64 format)

参数的整数值。

string (int64 format)

参数的整数值。

boolean

参数的布尔值。

object

包含 messageValue 对象的 activity.list。

object (NestedParameter)

参数值

object

每条活动记录的唯一标识符。

string

活动的发生时间。这是 UNIX 纪元时间（以秒为单位）。

string (int64 format)

唯一限定符（如果多个事件同时发生）。

string

事件所属的应用名称。如需了解可能的值，请参阅上述 applicationName 中的应用列表。

string

Google Workspace 账号的唯一标识符。

object

执行操作的用户。

string

执行者的唯一 Google Workspace 个人资料 ID。如果执行者不是 Google Workspace 用户，则此值可能不存在，或者可能是充当占位符 ID 的数字 105250506097979753968。

string

操作者的主电子邮件地址。如果没有与演员关联的电子邮件地址，则可能不存在。

string

演员的类型。

string

仅当 callerType 为 KEY 时，此字段才会显示。可以是 OAuth 2LO API 请求的请求者的 consumer_key，也可以是机器人账号的标识符。