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ả thiết bị trong chế độ 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 báo cáo cơ bản với các tham số cụ thể cho báo cáo, chẳng hạn 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ạn chỉ có thể sử dụng báo cáo hoạt động kiểm tra thiết bị cho mục đích hợp pháp theo thoả thuận với khách hàng. Hãy xem bài viết So sánh các phiên bản Google Workspace để biết những phiê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ả 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 yêu cầu HTTP GET sau đây và thêm mã 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, hãy xem phần Sự kiện hoạt động kiểm tra thiết bị.
Để dễ đọc, ví dụ sau được định dạng bằng cách xuống 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 sẽ lấy báo cáo về tất cả sự kiện kiểm tra thiết bị của tài khoản trong 180 ngày qua. Tham số truy vấn maxResults trả về 25 kết quả trên mỗi trang.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25
Ví dụ sau đây sẽ lấy báo cáo về tất cả sự kiện kiểm tra thiết bị trong 180 ngày qua. customerId chỉ định báo cáo của khách hàng nào đượ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ể muốn truy xuất các sự kiện cụ thể, chẳng hạn như 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 ở dạng 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 cho biết 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