裝置稽核活動報表會傳回 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