Reports API:裝置稽核活動報告

裝置稽核活動報告會傳回 Google 端點管理服務中所有裝置的活動相關資訊。每份報表都會使用基本報表端點要求和報表專用的參數,例如使用者的電子郵件。每份報表的時間範圍上限是過去 180 天。

裝置稽核活動報告只能用於遵守《客戶協議》的法律用途。請參閱「比較 Google Workspace 版本」,看看哪些版本內含這些報表。

擷取網域的裝置稽核事件

如要擷取網域中所有使用者的裝置稽核事件,請使用下列 GET HTTP 要求,並附上授權說明文件中所述的授權權杖。如要進一步瞭解要求查詢字串和回應屬性,請參閱「裝置稽核活動事件」。為了方便閱讀,以下範例採用換行格式:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?endTime=end date&startTime=start date
&maxResults=maximum number of events returned on a response page

以下範例會取得帳戶過去 180 天內所有的裝置稽核事件報告。maxResults 查詢參數會在每頁傳回 25 筆結果。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25

以下範例會取得過去 180 天內所有裝置稽核事件的報表。customerId 會指定擷取哪些客戶的報表。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb

依事件名稱擷取裝置稽核事件

在某些情況下,您可能會想擷取特定事件,例如可疑活動。如要執行此操作,請使用下列格式使用 GET HTTP 要求:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?maxResults=maximum number of events returned on a response page
&eventName=name of the event
&filters=event parameter relational operator parameter value

以下範例說明如何擷取網域中 Android 使用者的所有可疑活動事件:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25