Tổng quan về API Báo cáo

Reports API là một API dựa trên REST mà bạn có thể dùng để truy cập vào thông tin về hoạt động của người dùng trên Google Workspace. Reports API là một phần của Admin SDK API.

Reports API 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 dịch vụ cụ thể, 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 Mức sử dụng, liệt kê các sự kiện trong không gian làm việc do người dùng gây ra.
    • Báo cáo khách hàng liệt kê các sự kiện của tất cả người dùng trong miền của bạn.
    • Người dùng: Báo cáo mức sử dụng liệt kê các sự kiện được sắp xếp theo người dùng.

Sau đây là danh sách các thuật ngữ thường dùng trong Reports API:

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 ứng dụng hoặc dịch vụ cụ thể của Google Workspace. Báo cáo hoạt động bao gồm ngày, giờ, người dùng và loại hoạt động. Tài liệu tham khảo API có danh sách đầy đủ các báo cáo hoạt động và thông tin mà các báo cáo này cung cấp. Dưới đây là một số ví dụ về báo cáo hoạt động, đượ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 cho biết những hoạt động mà 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ả những lần quản trị viên thay đổi tên 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 cho biết 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. Ví dụ: bạn có thể xem 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 tài khoản của bạn đăng nhập và đăng xuất khỏi tài khoản của họ. Ví dụ: bạn có thể nhận được báo cáo về tất cả các lượt đăng nhập cho miền của mình trong một khoảng thời gian cụ thể.
  • Báo cáo hoạt động trên thiết bị di động cho biết các hoạt động sử dụng thiết bị di động do Google Mobile Management quản lý. 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ấp hoặc thu hồi mã thông báo uỷ quyền mà các trang web và ứng dụng bên thứ ba sử dụng. Bạn có thể sử dụng Reports API để lấy 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 trên Google Workspace.
Báo cáo về mức sử dụng

Báo cáo sử dụng cung cấp thông tin về các sự kiện trên Google Workspace trong miền của bạn. Bạn có thể sử dụng API này để yêu cầu thông tin cụ thể về người dùng.

  • Báo cáo về mức sử dụng của khách hàng liệt kê thông tin chi tiết về hoạt động của ứng dụng và dịch vụ trong tài khoản của bạn. Thông tin 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 về mức sử dụng của người dùng cho biết hoạt động của người dùng trong tài khoản của bạn. Bạn có thể tuỳ chỉnh và lọc các báo cáo này để xem thông tin sử dụng cụ thể. Thông tin sử dụng này được sắp xếp theo loại ứng dụng và chứa thông tin cụ thể cho ứng dụng đó.
  • Báo cáo về việc sử dụng thực thể liệt kê các hoạt động liên quan đến thực thể mà người dùng tài khoản của bạn sử dụng trong ứng dụng Currents.
Thông báo
Reports API 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ư thay đổi đối với tài nguyên. Khi bạn đang theo dõi một tài nguyên và tài nguyên đó thay đổi, Reports API sẽ gửi cho bạn một thông báo. Để biết thêm thông tin về cách thiết lập và nhận thông báo từ Reports API, hãy xem hướng dẫn về Cách nhận thông báo đẩy.

Các bước tiếp theo