管理員活動報表

管理員活動報表會傳回帳戶中所有管理員的管理控制台活動資訊。每份報表都會使用基本報表端點要求，以及報表專屬參數，例如管理員名稱或特定管理控制台事件。每份報表的時間範圍上限為過去 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.comOLD_VALUEALLOW_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 requester 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 requester 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": ""
       }
      ]
     }
    ]
   }
  ]
 }