Google Drive Activity API 包含 DriveActivity
資源 (代表使用者 Google 雲端硬碟中物件變更) 和 activity.query
方法 (可讓您擷取有關異動的資訊)。
要求
應用程式使用 activity.query
方法要求使用者的活動資料。您可以要求特定雲端硬碟項目或雲端硬碟資料夾內所有項目的活動。針對特定要求,您可以選擇透過時間範圍或動作類型等限制來限制回應,且可以選擇在回應中「整合」活動。詳情請參閱在 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 資料模型。
活動記錄顯示設定
使用這個 API 時,系統可能不會回報雲端硬碟中的部分活動。至於 Drive Activity API 是否會回報物件的特定變更,則取決於應用程式中已驗證的使用者是否能看到變更或相關資訊。
瀏覽權限取決於為物件設定的權限。在某些情況下,共用雲端硬碟中的檔案和資料夾會處於共用狀態:
- 如果作者共用文件,則除了建立者,並且經過驗證的使用者皆可查看文件的活動記錄。
- 如果與使用者共用文件,但將文件設為私人狀態,則通過驗證的使用者可在他們獲得存取權時,查看所有活動記錄,而權限現在受到限制。
- 如果從未與使用者共用文件,使用者就無法查看任何活動記錄。
開始使用
如要讓 Drive Activity API 發揮最大效益,請先將應用程式與 Google Drive API 整合。如要開始使用 Drive Activity API,請瞭解如何建立專案及授權要求。或是直接閱讀 API 參考資料中的活動相關資訊。