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
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-08-29。
[null,null,["最后更新时间 (UTC)：2025-08-29。"],[],[],null,["# Reports API: Device Audit Activity Report\n\nThe device audit activity report returns information on activities by all\ndevices under\n[Google endpoint management](https://support.google.com/a/answer/1734200).\nEach report uses the basic report endpoint request with report-specific\nparameters such as a user's email. The maximum time period for each report is\nthe last 180 days.\n\nThe device audit activity report may be used only for lawful purposes in\naccordance with your Customer Agreement. See\n[Compare Google Workspace editions](https://support.google.com/a/answer/6043385#reports)\nto find which editions include these reports.\n\nRetrieve device audit events for a domain\n-----------------------------------------\n\nTo retrieve all device audit events for all users within your domain, use the\nfollowing `GET` HTTP request and include the authorization token described in the\n[authorization documentation](/workspace/admin/reports/v1/guides/authorizing).\nFor more information about the request query strings and response properties,\nsee\n[Device Audit Activity Events](/workspace/admin/reports/v1/appendix/activity/mobile).\nFor readability purposes, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/mobile?endTime=end date&startTime=start date\n&maxResults=maximum number of events returned on a response page\n```\n\nThe following example gets a report on all of your account's device audit events\nfor the past 180 days. The `maxResults` query parameter returns 25 results per\npage. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25\n```\n\nThe following example gets a report on all device audit events for the past 180\ndays. The `customerId` specifies which customer's report is retrieved. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb\n```\n\nRetrieve device audit events by event name\n------------------------------------------\n\nIn some instances, you may want to retrieve specific\n[events](/workspace/admin/reports/v1/appendix/activity/mobile),\nsuch as suspicious activity events. To do this, use a `GET` HTTP request in\nthe following form: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/mobile?maxResults=maximum number of events returned on a response page\n&eventName=name of the event\n&filters=event parameter relational operator parameter value\n```\n\nThe following example shows how to retrieve all suspicious activity events for\nAndroid users within the domain: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25\n```"]]
