Reports API：云端硬盘活动报告

云端硬盘活动报告提供有关用户活动 在 Google Workspace 中管理、修改和共享 Google 云端硬盘中的文件。 例如，您可以使用“云端硬盘活动”报告来获取列表 特定用户在 Google 云端硬盘上创建的所有新文档 指定日期范围您可以利用这些信息深入了解 更好的内容管理以及可能的数据泄露。要获取报告，您可以使用 带有报告专用参数（例如 用户的电子邮件地址或特定类型的 Google 云端硬盘更改。报告可以 包含过去 180 天的数据。

Google 云端硬盘活动报告只能用于符合以下条件的账号： 获得许可。

有关请求的查询字符串和响应属性的信息， 请参阅 API 参考。对于 有关特定事件的信息，请参阅 云端硬盘事件名称。

检索网域的 Google 云端硬盘事件

您可以使用云端硬盘活动报告列出您的 云端硬盘文档。例如，您可以请求列出报告 您账号中最近的 25 次云端硬盘活动，涵盖多达 180 次 天。要获取此报告，请按照 授权指南，然后使用 以下 HTTP GET 请求：

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25

您可以查看此 API 调用的示例响应。

以下示例检索所有云端硬盘的报告 过去 180 天的事件，这是最长期限。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive

按用户检索 Google 云端硬盘事件

要检索特定用户的 Google 云端硬盘活动报告，请使用 HTTP GET 请求以及 授权指南指南。 userKey 字段是报告中用户的主电子邮件地址，或者 all（针对所有用户）。

以下示例检索一个报告，其中列出了 指定用户的身份。有关 API 响应的示例，请参阅 JSON 响应示例。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive

检索共享云端硬盘的 Google 云端硬盘事件

您可以检索特定共享云端硬盘的 Google 云端硬盘活动报告 使用 HTTP GET 请求和 授权指南。指定 您要为其生成报表的用户的电子邮件地址（在 userKey 字段中）； 或指定 all，以针对所有用户运行报告。

以下示例检索一个报告，其中包含特定共享 。有关 API 响应的示例，请参阅 JSON 响应示例。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>

如需检索共享云端硬盘的事件，请使用 doc_type 进行过滤。通过 以下示例检索影响所有共享云端硬盘的事件：

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive

要检索成员资格更改的事件，请指定 shared_drive_membership_change 事件。以下示例检索添加到共享云端硬盘的所有成员：

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive

按事件类型检索 Google 云端硬盘事件

若要检索特定事件类型（如创建 或修改文档，请使用已获得授权的 HTTP GET 请求 如授权指南中所述。 userKey 字段是报告中用户的主电子邮件地址，或者 all（针对所有用户）。

以下示例检索所有账号文档创建报告 活动。如需查看 API 响应的示例，请参阅 JSON 响应示例：

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create

JSON 响应示例

当您向 API 发出 HTTP GET 请求时，成功的响应会返回 HTTP 200 状态代码。响应将返回状态代码以及相应的响应 。这些报告还可在 管理控制台。有关详情，请参阅 Google Workspace 管理员帮助中心。 如需了解 eventName，请参阅 云端硬盘事件名称 参考。有关该请求的查询字符串和 请参阅 API 参考。

{
 "kind": "reports#auditActivities",
 "nextPageToken": "next page's token",
 "items": [
  {
   "kind": "audit#activity",
   "id": {
    "time": "2014-03-17T15:39:18.460Z",
    "uniqQualifier": "report's unique ID",
    "applicationName": "drive",
    "customerId": "ABC123xyz"
   },
   "actor": {
   "callerType": "USER",
   "email": "kim@example.com",
   "profileId": "user's unique Google Workspace profile ID",
   "key": "consumer key of requestor in an OAuth 2LO request"
   },
   "ownerDomain": "domain of the source owner",
   "ipAddress": "user's IP address",
   "events": [
    {
     "type": "access",
     "name": "edit",
     "parameters": [
      {
        "name": "primary_event",
        "boolValue": true
      },
      {
        "name": "owner_is_shared_drive",
        "boolValue": false
      },      {
        "name": "doc_id",
        "value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8"
      },
      {
        "name": "doc_title",
        "value": "Meeting notes"
      },
      {
        "name": "doc_type",
        "value": "document"
      },
      {
        "name": "owner",
        "value": "mary@example.com"
      }
      ]
     }
    ]
   },
  ]
 }