Báo cáo hoạt động của quản trị viên

Báo cáo Hoạt động của quản trị viên trả về thông tin về các hoạt động trên Bảng điều khiển dành cho quản trị viên của tất cả các quản trị viên trong tài khoản của bạn. Mỗi báo cáo sử dụng yêu cầu điểm cuối của báo cáo cơ bản với các thông số dành riêng cho báo cáo, chẳng hạn như tên của quản trị viên hoặc một sự kiện cụ thể trên Bảng điều khiển dành cho quản trị viên. Khoảng thời gian tối đa cho mỗi báo cáo là 180 ngày qua.

Bạn chỉ có thể sử dụng báo cáo hoạt động quản trị cho các mục đích hợp pháp theo Thỏa thuận khách hàng. Ngoài ra, các báo cáo này áp dụng cho tài khoản Google Workspace, tài khoản Education và tài khoản ISP.

Truy xuất tất cả hoạt động quản trị

Để truy xuất báo cáo về tất cả các hoạt động quản trị được thực hiện cho tài khoản, hãy sử dụng yêu cầu HTTP GET sau và bao gồm mã thông báo uỷ quyền được mô tả trong tài liệu về uỷ quyền. Để biết thêm thông tin về chuỗi truy vấn và các thuộc tính phản hồi, hãy xem Tài liệu tham khảo API. Để dễ đọc, ví dụ sau đây được định dạng bằng lệnh trả về dòng:

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

Ví dụ sau đây tạo báo cáo về tất cả hoạt động quản trị của tài khoản trong 180 ngày qua. Đây là khoảng thời gian tối đa cho một báo cáo. Và chuỗi truy vấn maxResults xác định báo cáo này chứa hai sự kiện cho mỗi trang báo cáo. Để xem ví dụ về phản hồi API, hãy xem ví dụ về phản hồi JSON:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?maxResults=2

Ví dụ sau đây tạo báo cáo về tất cả hoạt động quản trị của khách hàng trong 180 ngày qua. customerId chỉ định khách hàng mà bạn cần truy xuất báo cáo.

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

Truy xuất tất cả hoạt động theo quản trị viên

Để truy xuất báo cáo về tất cả hoạt động của một quản trị viên cụ thể trên Bảng điều khiển dành cho quản trị viên, hãy sử dụng yêu cầu HTTP GET sau đây và thêm mã thông báo uỷ quyền được mô tả trong tài liệu về quá trình uỷ quyền. userKey là địa chỉ email chính của quản trị viên trong báo cáo. Để biết thêm thông tin về chuỗi truy vấn và các thuộc tính phản hồi, hãy xem Tài liệu tham khảo API. Để dễ đọc, ví dụ sau đây được định dạng bằng lệnh trả về dòng:

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

Ví dụ sau đây báo cáo tất cả thay đổi đối với ứng dụng Bảng điều khiển dành cho quản trị viên do john@example.com thực hiện, và phản hồi được lọc để trả về bất kỳ hoạt động nào có OLD_VALUE bằng ALLOW_CAMERA. Để xem ví dụ về phản hồi API, hãy xem ví dụ về phản hồi JSON. Để biết thông tin về các hoạt động, hãy xem tên sự kiện quản trị viên:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com
/applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA

Truy xuất tất cả hoạt động theo tên sự kiện

Để truy xuất báo cáo về tất cả hoạt động cho một tên sự kiện cụ thể, hãy sử dụng yêu cầu HTTP GET sau đây và thêm mã thông báo uỷ quyền được mô tả trong tài liệu về uỷ quyền. Để biết thông tin về eventName, hãy xem thông tin tham khảo về tên sự kiện quản trị viên. Để biết thêm thông tin về chuỗi truy vấn và các thuộc tính phản hồi, hãy xem Tài liệu tham khảo API. Để dễ đọc, ví dụ sau đây được định dạng bằng lệnh trả về dòng:

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

Ví dụ sau đây truy xuất báo cáo cho tất cả các trường hợp thay đổi họ của người dùng trên Bảng điều khiển dành cho quản trị viên. Để xem ví dụ về phản hồi API, hãy xem ví dụ về phản hồi JSON:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME

Truy xuất tất cả hoạt động theo sự kiện và quản trị viên

Để truy xuất báo cáo về tất cả thay đổi đối với tên sự kiện cụ thể do một quản trị viên cụ thể thực hiện, hãy sử dụng yêu cầu HTTP GET sau đây và thêm mã thông báo uỷ quyền được mô tả trong tài liệu về việc uỷ quyền. userKey là địa chỉ email chính của quản trị viên trong báo cáo. Để biết thông tin về eventName, hãy xem thông tin tham khảo về tên sự kiện quản trị viên. Để biết thêm thông tin về chuỗi truy vấn và các thuộc tính phản hồi, hãy xem Tài liệu tham khảo API. Để dễ đọc, ví dụ sau đây được định dạng bằng lệnh trả về dòng:

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

Ví dụ sau đây truy xuất báo cáo cho tất cả các thay đổi đối với Bảng điều khiển dành cho quản trị viên đối với họ của một người dùng cụ thể do john@example.com thực hiện. Để xem ví dụ về phản hồi API, hãy xem ví dụ về phản hồi JSON:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com
/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME

Phản hồi JSON mẫu cho báo cáo hoạt động của quản trị viên

Khi phản hồi thành công, hệ thống sẽ trả về mã trạng thái HTTP 200. Cùng với mã trạng thái, phản hồi sẽ trả về một báo cáo. Để biết thông tin về eventName, hãy xem thông tin tham khảo về tên sự kiện quản trị viên. Để biết thêm thông tin về chuỗi truy vấn URL của yêu cầu và thuộc tính phản hồi, hãy xem Tài liệu tham khảo 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": ""
       }
      ]
     }
    ]
   }
  ]
 }