本文概要說明 Google Drive Activity API。
您可以使用 Drive Activity API 查詢近期事件。您可以擷取所有活動的詳細記錄,包括每個事件的詳細資訊。這項功能有助於執行稽核等工作,因為您可以擷取包含 ActionDetail
、Actor
和 Target
資訊的精確活動。
Google Drive Activity API 包含 DriveActivity
資源,代表使用者 Google 雲端硬碟中物件的異動,以及 activity.query
方法,可讓您擷取這些異動的相關資訊。
要求
應用程式使用 activity.query
方法要求使用者的活動資料。您可以要求特定 Google 雲端硬碟項目的活動,也可以要求 Google 雲端硬碟資料夾中所有內容的活動。針對特定要求,您可以選擇使用篩選器 (例如時間範圍或動作類型) 限制回應,也可以選擇在回應中彙整活動。詳情請參閱「在 Google Drive Activity API 中提出要求」。
回應
回應會包含符合指定參數的活動清單,其中 DriveActivity
資源代表每項活動:
DriveActivity
資源是 Action
物件的集合,每個物件都是獨立的,就像事件一樣。Action
包含 ActionDetail
(例如 Create
或 Edit
)、Actor
(例如 User
或 Administrator
)、Target
(例如 DriveItem
或 Drive
),以及 Timestamp
或 TimeRange
。
DriveActivity
資源也包含摘要資訊,例如所有動作的每個 Actor
和 Target
、統一的 Timestamp
或 TimeRange
,以及 Action
中最重要或最具代表性的 ActionDetail
。
詳情請參閱「Drive Activity API 資料模型」。
活動記錄瀏覽權限
使用 Google Drive Activity API 時,系統可能不會回報部分雲端硬碟活動。API 是否會回報物件的特定變更,取決於應用程式中經過驗證的使用者是否能看到該變更或變更相關資訊。
可見度取決於物件的權限設定。在雲端硬碟中,檔案和資料夾的共用情形有以下幾種:
如果作者共用文件,建立者和共用對象都能查看文件的活動記錄。
如果文件曾與使用者共用,但後來設為私人,使用者可以查看擁有存取權期間的所有活動記錄,但無法查看權限受限後的活動記錄。
如果文件從未與使用者共用,使用者就無法查看任何活動記錄。
相關主題
- 如要充分運用 Drive Activity API,請先將應用程式與 Google Drive API 整合。
- 如要瞭解如何使用 Google Workspace API 進行開發,包括建立專案或處理驗證和授權,請參閱「使用 Google Workspace 開發」。
- 如要瞭解活動,請參閱 API 參考資料。