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