Google Drive Activity API 簡介

Google Drive Activity API 內含 DriveActivity 資源, 代表使用者對 Google 雲端硬碟中物件所做的變更,而 activity.query 方法,讓您可以 有關這些變更的資訊

要求

您的應用程式會使用 activity.query 方法,增加圍繞地圖邊緣的邊框間距。你可以要求進行活動 檔案,包括特定雲端硬碟項目或雲端硬碟中的任何項目 資料夾。針對特定要求,您可以選擇限制回應 限制 (例如時間範圍或動作類型), 可以選擇將活動整合到 回應。詳情請參閱在 Drive Activity API 中提出要求

回應

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

雲端硬碟活動說明。

DriveActivity 資源是一組 Action 物件, 以事件的形式獨立存在Action 包含 ActionDetail (例如 Create) 或 Edit)、Actor (例如 User) 或 AdministratorTarget (例如 例如 DriveItemDrive,以及 TimestampTimeRange

DriveActivity 資源還包含 摘要資訊,例如 「Actor」和 所有動作的Target (統一) TimestampTimeRange,以及 重要的或代表人 ActionDetail Action

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

活動記錄顯示設定

使用這個 API 時,系統可能不會回報雲端硬碟中的部分活動。無論 Drive Activity API 會根據 通過驗證的使用者可以看見變更的內容或相關資訊 應用程式內的使用者

瀏覽權限取決於為物件設定的權限。以下研究室中 在雲端硬碟中共用檔案和資料夾的情形:

  • 如果作者共用文件,系統會記錄該文件的活動記錄 不僅可供創作者查看,驗證的使用者也看得到 。
  • 如果您將一份文件與使用者共用,然後設為私人文件,則已通過驗證 使用者只要擁有存取權,即可查看所有活動記錄,以及權限目前無法存取的活動記錄 受到限制。
  • 如果從未與使用者共用文件,使用者就無法看到任何活動 。

開始使用

如要充分運用 Drive Activity API,請將應用程式與 Google Drive API。如要開始使用 Drive Activity API, 瞭解如何建立專案,並 授權要求。也可以直接閱讀 在 API 參考資料