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 參考資料中的活動相關資訊。