管理員活動報告會傳回所有帳戶管理員的管理控制台活動相關資訊。每份報表都會使用基本報表端點要求以及報表專用參數,例如管理員名稱或特定的管理控制台事件。每份報表的時間範圍最長為過去 180 天。
管理員活動報告只能依《客戶協議》的合法用途使用。此外,這些報告適用於 Google Workspace、Education 和 ISP 帳戶。
擷取所有管理活動
如要擷取帳戶中所有管理活動的報告,請使用以下 GET
HTTP 要求,並加入授權說明文件中所述的授權權杖。如要進一步瞭解要求的查詢字串和回應屬性,請參閱 API 參考資料。為了方便閱讀,以下範例採用換行格式:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?endTime=a date&startTime=a date &maxResults=number of events listed on each page of the report
以下範例會取得帳戶過去 180 天 (也就是報表時間上限) 內所有帳戶管理活動的報表。而 maxResults
查詢字串代表這份報表在每個報表頁麵包含兩個事件。如需 API 回應範例,請參閱 JSON 回應範例:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=2
以下範例取得客戶在過去 180 天內所有管理活動的報表。customerId
會指定要擷取報表的客戶。
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?customerId=C03az79cb
擷取管理員的所有活動
如要擷取特定管理員執行的所有管理控制台活動報告,請使用下列 GET
HTTP 要求,並附上授權說明文件中所述的授權權杖。userKey
是報表中的管理員主要電子郵件地址。如要進一步瞭解要求的查詢字串和回應屬性,請參閱 API 參考資料。為了方便閱讀,以下範例採用換行格式:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey /applications/admin?endTime=a date&startTime=a date &maxResults=number of events listed on each page of the report &filters=event name parameter relational operator parameter value
以下範例會回報 john@example.com
對管理控制台應用程式進行的所有變更,並篩選回應,傳回 OLD_VALUE
等於 ALLOW_CAMERA
的所有活動。如需 API 回應範例,請參閱 JSON 回應範例。如需活動相關資訊,請參閱管理員事件名稱:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA
按事件名稱擷取所有活動
如要擷取特定事件名稱所有活動的報表,請使用下列 GET
HTTP 要求,並加入授權說明文件中所述的授權權杖。如需 eventName
相關資訊,請參閱管理員事件名稱參考資料。如要進一步瞭解要求的查詢字串和回應屬性,請參閱 API 參考資料。為了方便閱讀,以下範例採用換行格式:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?endTime=a date&startTime=a date &maxResults=maximum number of events returned on a response page &eventName=name of the administrative event
以下範例會擷取管理控制台中所有變更使用者姓氏的報告。如需 API 回應範例,請參閱 JSON 回應範例:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
依事件和管理員擷取所有活動
如要擷取管理控制台針對特定事件名稱的所有變更報告,請使用以下 GET
HTTP 要求,並加入授權說明文件中所述的授權權杖。userKey
是報表中的管理員主要電子郵件地址。如需 eventName
相關資訊,請參閱管理員事件名稱參考資料。如要進一步瞭解要求的查詢字串和回應屬性,請參閱 API 參考資料。為了方便閱讀,以下範例採用換行格式:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey /applications/admin?endTime=a date&startTime=a date &maxResults=maximum number of events returned on a response page &eventName=name of the administrative event
以下範例會擷取在 john@example.com
之前,變更於特定使用者姓氏的所有管理控制台報表。如需 API 回應範例,請參閱 JSON 回應範例:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
管理員活動報告 JSON 回應範例
成功的回應會傳回 HTTP 200 狀態碼。回應會傳回狀態碼,以及傳回報告。如需 eventName
相關資訊,請參閱管理員事件名稱參考資料。如要進一步瞭解要求的網址查詢字串和回應屬性,請參閱 API 參考資料。
{ "kind": "reports#auditActivities", "nextPageToken": "the next page's token", "items": [ { "kind": "audit#activity", "id": { "time": "2011-06-17T15:39:18.460Z", "uniqueQualifier": "report's unique ID", "applicationName": "admin", "customerId": "C03az79cb" }, "actor": { "callerType": "USER", "email": "liz@example.com", "profileId": "user's unique Google Workspace profile ID", "key": "consumer key of requestor in OAuth 2LO requests" }, "ownerDomain": "example.com", "ipAddress": "user's IP address", "events": [ { "type": "GROUP_SETTINGS", "name": "CHANGE_GROUP_SETTING", "parameters": [ { "name": "SETTING_NAME", "value": "WHO_CAN_JOIN", "intValue": "integer value of parameter", "boolValue": "boolean value of parameter" } ] } ] }, { "kind": "audit#activity", "id": { "time": "2011-06-17T15:39:18.460Z", "uniqueQualifier": "reports unique ID", "applicationName": "admin", "customerId": "C03az79cb" }, "actor": { "callerType": "USER", "email": "liz@example.com", "profileId": "user's unique Google Workspace profile ID", "key": "consumer key of requestor in an OAuth 2LO request" }, "ownerDomain": "example.com", "ipAddress": "user's IP address", "events": [ { "type": "GROUP_SETTINGS", "name": "CREATE_GROUP", "parameters": [ { "name": "GROUP_EMAIL", "value": "helpdesk@example.com", "intValue": "", "boolValue": "" } ] } ] } ] }