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 管理員說明中心。