Reports API：雲端硬碟活動報告

當使用者在 Google Workspace 中管理、修改及共用檔案時，雲端硬碟活動報告會提供有關使用者活動的資訊。舉例來說，您可以使用雲端硬碟活動報表，取得特定使用者在指定日期範圍內建立的所有新雲端硬碟文件的清單。您可以運用這項資訊，深入瞭解更佳的內容管理和可能的資料外洩情形。如要取得報表，請在基本報表端點要求中使用報表專用參數，例如使用者電子郵件地址或特定類型的 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]"
      }
      ]
     }
    ]
   },
  ]
 }