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 或 Administrator)、Target (例如 DriveItem 或 Drive)，以及 Timestamp 或 TimeRange。

DriveActivity 資源也包含摘要資訊，例如所有動作的每個 Actor 和 Target、統一的 Timestamp 或 TimeRange，以及 Action 中最重要或最具代表性的 ActionDetail。

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

活動記錄瀏覽權限

使用這個 API 時，系統可能不會回報 Google 雲端硬碟的某些活動。Google Drive Activity API 是否會回報物件的特定變更，取決於經過驗證的使用者是否能在應用程式中看到該變更或變更相關資訊。

可見度取決於物件的權限設定。在雲端硬碟中，檔案和資料夾的共用情形有幾種：

  • 如果作者共用文件，則文件的活動記錄不僅會顯示給建立者，也會顯示給共用對象 (已通過驗證的使用者)。
  • 如果文件曾與使用者共用，但後來設為私人文件，通過驗證的使用者可以查看他們擁有存取權時的所有活動記錄，以及權限現在受到限制。
  • 如果文件從未與使用者共用，使用者就無法查看任何活動記錄。

開始使用

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