API Báo cáo: Báo cáo hoạt động kiểm tra thiết bị

Báo cáo hoạt động kiểm tra thiết bị trả về thông tin về hoạt động của tất cả các thiết bị dưới Giải pháp quản lý thiết bị đầu cuối của Google. 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 báo cáo dành riêng cho báo cáo như email của người dùng. Khoảng thời gian tối đa cho mỗi báo cáo là 180 ngày qua.

Báo cáo hoạt động kiểm tra thiết bị chỉ có thể được sử dụng cho các mục đích hợp pháp tại theo Thoả thuận khách hàng của bạn. Xem So sánh các phiên bản Google Workspace để tìm ấn bản có các báo cáo này.

Truy xuất sự kiện kiểm tra thiết bị cho một miền

Để truy xuất tất cả các sự kiện kiểm tra thiết bị cho tất cả người dùng trong miền của bạn, hãy sử dụng theo yêu cầu HTTP GET và bao gồm mã thông báo uỷ quyền được mô tả trong tài liệu uỷ quyền. Để biết thêm thông tin về chuỗi truy vấn yêu cầu và thuộc tính phản hồi, xem Sự kiện hoạt động kiểm tra thiết bị. Để 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/mobile?endTime=end date&startTime=start date
&maxResults=maximum number of events returned on a response page

Ví dụ sau đây tạo báo cáo về tất cả các sự kiện kiểm tra thiết bị trong tài khoản của bạn trong 180 ngày qua. Tham số truy vấn maxResults trả về 25 kết quả cho mỗi .

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

Ví dụ sau đây tạo báo cáo về tất cả các sự kiện kiểm tra thiết bị trong 180 ngày qua ngày. customerId chỉ định báo cáo của khách hàng cần được truy xuất.

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

Truy xuất sự kiện kiểm tra thiết bị theo tên sự kiện

Trong một số trường hợp, bạn có thể cần truy xuất dữ liệu cụ thể sự kiện, chẳng hạn như các sự kiện hoạt động đáng ngờ. Để thực hiện việc này, hãy sử dụng yêu cầu HTTP GET trong biểu mẫu sau:

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

Ví dụ sau đây trình bày cách truy xuất tất cả sự kiện hoạt động đáng ngờ cho Người dùng Android trong miền:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25