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/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"
      }
      ]
     }
    ]
   },
  ]
 }