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 通知，請參閱 接收推播通知。

後續步驟

• 如要瞭解 Reports API 並實際運作，請參閱快速入門導覽課程： 清單項目會依程式設計語言列在左側導覽列你可以 您也可以繼續閱讀本節，瞭解如何完成設定程序 即可。

• 授權 章節會說明如何使用 OAuth 2.0 存取權杖取得使用者資料 Google Workspace 應用程式和服務。

• 如要找出特定資源類型或方法的詳細資料，請參閱 API 參考資料。

• 詳情請參閱 Admin SDK API Issue Tracker 這個 Google Workspace 開發人員網誌， 和 Google Workspace 管理員說明中心。