Reports API:登录活动报告

“登录活动”报告会返回 您账号的用户每个报告都使用带有 报告特定参数(如用户的电子邮件)。通过 每个报告的最长时间段是过去 180 天。

根据《客户协议》,登录活动报告只能用于合法目的。

检索网域的 Google Workspace 登录事件

要检索您所在域的所有服务的所有登录,请使用以下 GET HTTP 请求,并包含 授权文档。 有关请求查询字符串和响应属性的详细信息, 请参阅 API 参考。 为便于阅读,以下示例采用回车行格式:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/login?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/login?maxResults=25

以下示例会获取客户所有登录事件的报告, 过去 180 天的数据customerId 指明了报告的客户 作为对象。

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

按事件名称检索 Google Workspace 登录事件

在某些情况下,您可能希望 事件, 例如可疑的成功登录为此,请使用 GET HTTP 请求,即 以下表单:

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

以下示例展示了如何检索所有可疑的成功登录 :

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25