Reports API:登入活動報告

登入活動報告會傳回所有登入活動相關資訊, 為帳戶使用者設定存取權每份報表都會使用基本報表端點請求 報表專屬的參數,例如使用者的電子郵件。 且最長時間範圍為過去 180 天。

您的登入活動報告只能在遵循「客戶協議」的合法目的的情況下使用。

擷取網域的 Google Workspace 登入事件

如要擷取網域所有服務的所有登入資訊,請使用下列範本 GET HTTP 要求,並加入 授權說明文件。 如需進一步瞭解要求查詢字串和回應屬性 請參閱 API 參考資料。 為了方便閱讀,下列範例採用換行格式:

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

以下範例會取得客戶所有登入事件的報表 過去 180 天的資料customerId 會指定報表屬於哪位客戶 。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?customerId=C03az79cb

按事件名稱擷取 Google Workspace 登入事件

在某些情況下,您可能會想要擷取 事件、 例如可疑的成功登入活動方法是將 GET HTTP 要求 格式如下:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/login?maxResults=maximum number of events returned on a response page
&eventName=name of the login event
&filters=event parameter relational operator parameter value

以下範例說明如何擷取所有可疑的成功登入記錄 定義網域:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25