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