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