Reports API 總覽

Reports API 是一種 RESTful 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 的通知，請參閱「接收推送通知」指南。

後續步驟