Reports API：云端硬盘活动报告

“云端硬盘活动”报告会提供用户在 Google Workspace 中管理、修改和共享 Google 云端硬盘中的文件时的活动信息。例如，您可以使用“云端硬盘活动”报告获取特定用户在指定的日期范围内创建的所有新云端硬盘文档的列表。您可以使用此信息深入了解如何进行更好的内容管理和潜在的数据泄露。如需获取报告，请使用基本报告端点请求和报告专用参数（例如用户的电子邮件地址或特定类型的 Google 云端硬盘更改）。报告最多可以包含过去 180 天的数据。

Google 云端硬盘活动报告只能用于已获得许可的账号的合法目的。

如需了解请求的查询字符串和响应属性，请参阅 API 参考文档。如需了解与 Google 云端硬盘相关的特定事件，请参阅云端硬盘事件名称。

检索网域的 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/[e-mail]
/applications/drive

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

您可以使用 HTTP GET 请求和授权指南中所述的授权令牌，检索特定共享云端硬盘的 Google 云端硬盘活动报告。在 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": "[e-mail]",
   "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": "[e-mail]"
      }
      ]
     }
    ]
   },
  ]
 }