Google Drive Activity API 簡介

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

要求

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

回應

要求的回應會是符合指定參數的活動清單,其中 DriveActivity 資源代表各個活動:

雲端硬碟活動說明。

DriveActivity 資源是一系列 Action 物件,每個物件都像是 eventevent<br class="ph-1-1Action 包含 ActionDetail (例如 CreateEdit)、Actor (例如 UserAdministrator)、Target (例如 DriveItemDrive),以及 TimestampTimeRange

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

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

活動記錄顯示設定

使用這個 API 時,系統可能不會回報雲端硬碟上的某些活動。視該變更或關於變更的資訊而定,Drive Activity API 是否會向應用程式中的通過驗證的使用者顯示該變更或相關資訊的資訊,才能回報給出指定的物件變更。

瀏覽權限取決於針對物件設定的權限。在雲端硬碟中共用檔案和資料夾時,會出現以下幾種情況:

  • 如果作者共用文件,則文件的活動記錄不僅可供建立者查看,共用對像也看得到該文件的共用對象。
  • 如果將文件與使用者共用,然後設為不公開,則通過驗證的使用者在擁有存取權時可以查看所有活動記錄,且權限現已限制。
  • 如果從未與使用者共用文件,使用者則看不到任何活動記錄。

立即開始

如要充分運用 Drive Activity API,請先將您的應用程式與 Google Drive API 整合。如要開始使用 Drive Activity API,請參閱建立專案授權要求的相關說明。或者,您也可以直接閱讀 API 參考資料,瞭解活動相關資訊。