雲端硬碟活動報表會提供使用者在 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 天 (最長期限) 的所有 Google 雲端硬碟事件報表。
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 雲端硬碟事件
您可以使用 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
event。以下範例會擷取共用雲端硬碟的所有成員新增作業：
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 雲端硬碟的報表。您也可以在管理控制台查看這些報表。詳情請參閱 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"
}
]
}
]
},
]
}