Reports API 總覽

Reports API 是符合 REST 樣式的 API,可用來存取使用者 Google Workspace 活動的相關資訊。Reports API 是 Admin SDK API 的一部分。

Reports API 提供兩種報表:

  • 活動:回報特定應用程式或服務 (例如 Google 雲端硬碟或管理控制台) 的事件。
  • 用量報表:列出使用者產生的 Workspace 事件。
    • 客戶使用情形報告會列出您網域中所有使用者的事件。
    • 使用者使用情形報告會列出依使用者分類的事件。

以下是 Reports API 常用的詞彙清單:

活動報告

活動報表會列出特定 Google Workspace 應用程式或服務中的活動資訊。活動報表內含日期、時間、使用者和活動類型。API 參考資料包含活動報表的完整清單,以及當中的資訊。以下是一些活動報告範例,按應用程式或服務列出:

  • 管理員活動報告會顯示管理員使用管理控制台執行的活動。舉例來說,您可以使用管理控制台取得管理員變更使用者名稱的所有時間清單。
  • Google 雲端硬碟活動報表會列出網域使用者編輯及檢視其雲端硬碟文件的方式。舉例來說,您可以取得特定使用者的雲端硬碟活動清單。
  • 登入活動報表提供帳戶使用者登入及登出帳戶的資訊。舉例來說,您可以取得網域在特定時間範圍內的所有登入資料報告。
  • 行動裝置活動報告會顯示由 Google 行動管理服務管理的行動裝置所進行的活動。舉例來說,您可以在使用者註冊新裝置時通知您。
  • OAuth 權杖活動報表會列出使用者授予或撤銷第三方網站和應用程式使用授權權杖的事件。您可以使用 Reports API 取得所有第三方存取使用者 Google Workspace 資料的清單。
用量報表

用量報表可提供您網域中 Google Workspace 事件的相關資訊。 您可以使用這個 API 要求使用者的特定資訊。

  • 客戶使用情形報表會列出帳戶中詳細的應用程式和服務活動。這些使用資訊會按照應用程式類型整理,其中包含該應用程式的資訊。
  • 使用者使用情形報表會顯示您帳戶使用者的活動。您可以自訂及篩選特定使用資訊。這些使用資訊會按照應用程式類型整理,其中包含該應用程式的資訊。
  • 實體使用情形報表會列出 Currents 應用程式中使用者帳戶使用者所用實體的活動。
通知
Reports API 提供通知,可讓您監控資源變更等事件。當您在查看資源且資源有所變更時,Reports API 會傳送通知給您。如要進一步瞭解如何設定及接收 Reports API 通知,請參閱接收推播通知指南。

後續步驟