Google Drive Activity API 簡介

本文概要說明 Google Drive Activity API。

您可以使用 Drive Activity API 查詢近期事件。您可以擷取所有活動的詳細記錄,包括每個事件的詳細資訊。這項功能有助於執行稽核等工作,因為您可以擷取包含 ActionDetailActorTarget 資訊的精確活動。

Google Drive Activity API 包含 DriveActivity 資源,代表使用者 Google 雲端硬碟中物件的異動,以及 activity.query 方法,可讓您擷取這些異動的相關資訊。

要求

應用程式使用 activity.query 方法要求使用者的活動資料。您可以要求特定 Google 雲端硬碟項目的活動,也可以要求 Google 雲端硬碟資料夾中所有內容的活動。針對特定要求,您可以選擇使用篩選器 (例如時間範圍或動作類型) 限制回應,也可以選擇在回應中彙整活動。詳情請參閱「在 Google Drive Activity API 中提出要求」。

回應

回應會包含符合指定參數的活動清單,其中 DriveActivity 資源代表每項活動:

說明 Google Drive Activity API 回應主體訊息。
圖 1. 說明 Google Drive Activity API 回應主體訊息。

DriveActivity 資源是 Action 物件的集合,每個物件都是獨立的,就像事件一樣。Action 包含 ActionDetail (例如 CreateEdit)、Actor (例如 UserAdministrator)、Target (例如 DriveItemDrive),以及 TimestampTimeRange

DriveActivity 資源也包含摘要資訊,例如所有動作的每個 ActorTarget、統一的 TimestampTimeRange,以及 Action 中最重要或最具代表性的 ActionDetail

詳情請參閱「Drive Activity API 資料模型」。

活動記錄瀏覽權限

使用 Google Drive Activity API 時,系統可能不會回報部分雲端硬碟活動。API 是否會回報物件的特定變更,取決於應用程式中經過驗證的使用者是否能看到該變更或變更相關資訊。

可見度取決於物件的權限設定。在雲端硬碟中,檔案和資料夾的共用情形有以下幾種:

  • 如果作者共用文件,建立者和共用對象都能查看文件的活動記錄。

  • 如果文件曾與使用者共用,但後來設為私人,使用者可以查看擁有存取權期間的所有活動記錄,但無法查看權限受限後的活動記錄。

  • 如果文件從未與使用者共用,使用者就無法查看任何活動記錄。