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