Google Drive Activity API 簡介

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

要求

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

回應

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

雲端硬碟活動說明。

DriveActivity 資源是 Action 物件的集合,每個物件都是獨立的,就像一個事件一樣。Action 包含 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 參考資料中,深入瞭解活動內容。