Reports API 總覽

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

Reports API 提供兩種報表:

  • 活動報告:回報特定應用程式的事件,或 服務,例如 Google 雲端硬碟或管理控制台。
  • 使用情形報表:列出使用者導致的工作區事件。
    • 客戶使用情形報告會列出網域中所有使用者的事件。
    • 使用者使用情形報告會列出依使用者分類的事件。

以下列出 Reports API 的常見詞彙:

活動報告

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

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

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

  • 客戶使用情形報表 列出帳戶中詳細的應用程式和服務活動。此用量 資訊會按照應用程式類型分類,其中包含 專屬於該應用程式
  • 使用者使用情形報告 顯示帳戶使用者的活動。這類報表可自訂報表 篩選特定使用資訊我們會彙整這些使用資訊 且包含該應用程式的特定資訊。
  • 實體用量報表 列出您的帳戶使用者所用實體的相關活動 Currents 應用程式。
通知
Reporting API 提供通知,可讓你監控事件,例如 對資源的變更查看資源時,如果資源有所變更 Reports API 會傳送通知給您。如要進一步瞭解 接收 Reports API 通知,請參閱 接收推播通知

後續步驟