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