Báo cáo hoạt động đăng nhập trả về thông tin về hoạt động đăng nhập của tất cả người dùng 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ố theo báo cáo cụ thể như email của người dùng. Chiến lược phát hành đĩa đơ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 đăng nhập cho các mục đích hợp pháp theo Thoả thuận khách hàng của mình.
Truy xuất sự kiện đăng nhập Google Workspace cho một miền
Để truy xuất tất cả thông tin đăng nhập cho tất cả dịch vụ trong miền của bạn, hãy sử dụng các
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,
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/login?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 đăng nhập trong tài khoản của bạn cho
180 ngày qua. Tham số truy vấn maxResults có trả về báo cáo này
25 kết quả trên mỗi trang.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?maxResults=25
Ví dụ sau đây tạo báo cáo về tất cả sự kiện đăng nhập của khách hàng cho
180 ngày qua. customerId chỉ định khách hàng cần báo cáo
để được truy xuất.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?customerId=C03az79cb
Truy xuất sự kiện đăng nhập Google Workspace 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ư lần đăng nhập thành công đáng ngờ. Để thực hiện việc này, hãy sử dụng yêu cầu HTTP GET của
biểu mẫu sau:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/login?maxResults=maximum number of events returned on a response page &eventName=name of the login event &filters=event parameter relational operator parameter value
Ví dụ sau minh hoạ cách truy xuất tất cả lượt đăng nhập thành công đáng ngờ dành cho một miền:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25