Báo cáo Hoạt động mã thông báo uỷ quyền trả về thông tin về bên thứ ba các trang web và ứng dụng mà người dùng đã cấp quyền truy cập. Từng 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 thông số dành riêng cho báo cáo như khi miền của bên thứ ba hoặc phạm vi uỷ quyền đã được cấp. Thời gian tối đa khoảng thời gian 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 liên quan đến mã thông báo OAuth cho các mục đích hợp pháp theo Thoả thuận khách hàng.
Truy xuất tất cả sự kiện mã thông báo uỷ quyền cho một miền
Để truy xuất tất cả sự kiện uỷ quyền cho các ứng dụng bên thứ ba, 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,
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/token?endTime=end date&startTime=start date &maxResults=maximum number of events returned on a response page
Ví dụ sau đây sẽ tạo báo cáo về tất cả các sự kiện uỷ quyền trong tài khoản của bạn
trong 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/token?maxResults=25
Truy xuất sự kiện mã thông báo uỷ quyền theo tên sự kiện
Trong một số trường hợp, bạn nên truy xuất các sự kiện cụ thể, chẳng hạn như
đã bị thu hồi quyền truy cập của ứng dụ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/token?maxResults=maximum number of events returned on a response page &eventName=name of the OAuth token event
Ví dụ sau đây trình bày cách truy xuất tất cả sự kiện revoke của một miền:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?eventName=revoke&maxResults=25