Reports API:授权令牌活动报告

授权令牌活动报告会返回用户已授予访问权限的第三方网站和应用的相关信息。每个报告都使用基本报告端点请求,并附带报告专用参数(例如授予的第三方网域或授权范围)。每份报告的最长时间段为过去 180 天。

根据《客户协议》,“OAuth 令牌活动”报告只能用于合法目的。

检索网域的所有授权令牌事件

如需检索第三方应用的所有授权事件,请使用以下 GET HTTP 请求并包含授权文档中所述的授权令牌。如需详细了解请求查询字符串和响应属性,请参阅 API 参考文档。为确保可读性,以下示例采用了使用回车符的格式:

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

按事件名称检索授权令牌事件

在某些情况下,您可能需要检索特定事件,例如应用的访问权限是否已被撤消。为此,请使用以下形式的 GET HTTP 请求:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/token?maxResults=maximum number of events returned on a response page
&eventName=name of the OAuth token event

以下示例展示了如何检索网域的所有 revoke 事件:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?eventName=revoke&maxResults=25