API Báo cáo là một API RESTful mà bạn có thể dùng để truy cập thông tin về Hoạt động của người dùng trên Google Workspace. API Báo cáo là một phần của API SDK dành cho quản trị viên.
API Báo cáo cung cấp 2 loại báo cáo:
- Báo cáo Hoạt động báo cáo các sự kiện cho một ứng dụng hoặc chẳng hạn như Google Drive hoặc Bảng điều khiển dành cho quản trị viên.
- Báo cáo Sử dụng: liệt kê các sự kiện trong không gian làm việc do người dùng tạo ra.
- Báo cáo sử dụng dành cho khách hàng liệt kê các sự kiện cho tất cả người dùng trong miền của bạn.
- Báo cáo về việc sử dụng của người dùng liệt kê các sự kiện theo người dùng tổ chức.
Sau đây là danh sách các thuật ngữ phổ biến được dùng trong API Báo cáo:
- Báo cáo hoạt động
Báo cáo hoạt động liệt kê thông tin về các hoạt động trong một Google Workspace cụ thể ứng dụng hoặc dịch vụ của bạn. Báo cáo hoạt động bao gồm ngày, giờ, người dùng và loại của hoạt động. Chiến lược phát hành đĩa đơn Tài liệu tham khảo API chứa danh sách đầy đủ các báo cáo hoạt động và thông tin trong đó. Dưới đây là một số báo cáo hoạt động mẫu được liệt kê theo ứng dụng hoặc dịch vụ:
- Báo cáo hoạt động của quản trị viên hiển thị các hoạt động do quản trị viên thực hiện bằng Bảng điều khiển dành cho quản trị viên. Ví dụ: bạn có thể nhận được danh sách tất cả các lần quản trị viên thay đổi tên của người dùng bằng Bảng điều khiển dành cho quản trị viên.
- Báo cáo hoạt động trên Google Drive liệt kê cách người dùng trong miền của bạn chỉnh sửa và xem tài liệu trên Drive của họ. Cho ví dụ: bạn có thể tải danh sách hoạt động của một người dùng cụ thể trên Drive.
- Báo cáo hoạt động đăng nhập cung cấp thông tin về thời điểm người dùng trong tài khoản của bạn đăng nhập và đăng xuất khỏi tài khoản. Ví dụ: bạn có thể nhận được báo cáo về tất cả các thông tin đăng nhập cho trong một khoảng thời gian cụ thể.
- Báo cáo hoạt động trên thiết bị di động hiển thị các hoạt động sử dụng thiết bị di động được quản lý bằng Google Mobile Management. Ví dụ: bạn có thể nhận được thông báo khi người dùng đăng ký một thiết bị mới.
- Báo cáo hoạt động của mã thông báo OAuth liệt kê các sự kiện khi người dùng của bạn đã cung cấp hoặc thu hồi mã thông báo uỷ quyền đã dùng theo các trang web và ứng dụng của bên thứ ba. Bạn có thể dùng API Báo cáo để nhận danh sách tất cả quyền truy cập của bên thứ ba vào dữ liệu của người dùng trong Google Workspace.
- Báo cáo sử dụng
Báo cáo về việc sử dụng cung cấp thông tin về các sự kiện của Google Workspace trong miền của bạn. Bạn có thể sử dụng API để yêu cầu thông tin cụ thể về người dùng.
- Báo cáo mức sử dụng của khách hàng liệt kê các hoạt động ứng dụng và dịch vụ chi tiết trong tài khoản của mình. Mức sử dụng này thông tin được sắp xếp theo loại ứng dụng và chứa thông tin dành riêng cho ứng dụng đó.
- Báo cáo mức sử dụng của người dùng hiển thị hoạt động của người dùng tài khoản của bạn. Bạn có thể tuỳ chỉnh các báo cáo này và để biết thông tin sử dụng cụ thể. Thông tin về mức sử dụng này đã được sắp xếp theo loại ứng dụng và chứa thông tin dành riêng cho ứng dụng đó.
- Báo cáo mức sử dụng thực thể liệt kê các hoạt động có liên quan đến pháp nhân được người dùng tài khoản của bạn sử dụng trong Ứng dụng Currents.
- Thông báo
- API Báo cáo cung cấp các thông báo cho phép bạn theo dõi các sự kiện, chẳng hạn như các thay đổi đối với tài nguyên. Khi bạn xem một tài nguyên và tài nguyên đó thay đổi, API Báo cáo sẽ gửi thông báo cho bạn. Để biết thêm thông tin về cách thiết lập và nhận thông báo từ API Báo cáo, hãy xem hướng dẫn để Nhận thông báo đẩy.
Các bước tiếp theo
Để tìm hiểu về API Báo cáo và xem API này có hoạt động hay không, hãy sử dụng Quickstart, được liệt kê theo ngôn ngữ lập trình trên thanh điều hướng bên trái. Bạn có thể Bạn cũng có thể tiếp tục đọc phần này để đọc thông tin chung về cách thiết lập tài khoản của bạn.
Chiến lược phát hành đĩa đơn uỷ quyền trong đó có trình bày cách sử dụng mã truy cập OAuth 2.0 để lấy dữ liệu người dùng từ Các ứng dụng và dịch vụ của Google Workspace.
Để tìm thông tin chi tiết về một loại tài nguyên hoặc phương thức cụ thể, hãy xem Tài liệu tham khảo API.
Để biết thêm thông tin, hãy xem Công cụ theo dõi lỗi của API SDK dành cho quản trị viên, thời gian Blog dành cho nhà phát triển Google Workspace và Trung tâm trợ giúp dành cho quản trị viên Google Workspace.