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