Báo cáo hoạt động trên Drive cung cấp thông tin về hoạt động của người dùng khi họ quản lý, sửa đổi và chia sẻ tệp trên Google Drive trong Google Workspace. Ví dụ: bạn có thể sử dụng báo cáo hoạt động trên Drive để xem danh sách tất cả các tài liệu mới trên Drive do một người dùng cụ thể tạo trong một phạm vi ngày cụ thể. Bạn có thể sử dụng thông tin này để hiểu rõ hơn về việc quản lý nội dung và khả năng rò rỉ dữ liệu. Để nhận báo cáo, bạn sử dụng yêu cầu cơ bản về điểm cuối báo cáo với các thông số dành riêng cho báo cáo, chẳng hạn như địa chỉ email của người dùng hoặc một loại thay đổi cụ thể trên Google Drive. Báo cáo có thể bao gồm dữ liệu trong tối đa 180 ngày qua.
Báo cáo hoạt động trên Google Drive chỉ được dùng cho các mục đích hợp pháp trong những tài khoản đã được cấp giấy phép.
Để biết thông tin về các chuỗi truy vấn của yêu cầu và các thuộc tính phản hồi, hãy xem Tài liệu tham khảo về API. Để biết thông tin về các sự kiện cụ thể liên quan đến Google Drive, hãy xem Tên sự kiện trên Drive.
Truy xuất các sự kiện trên Google Drive cho một miền
Bạn có thể sử dụng báo cáo hoạt động trên Drive để liệt kê thông tin về các tài liệu trên Drive. Ví dụ: bạn có thể yêu cầu một báo cáo liệt kê 25 sự kiện gần đây nhất trên Drive của tài khoản, trong khoảng thời gian tối đa 180 ngày. Để nhận báo cáo này, hãy lấy mã thông báo uỷ quyền như mô tả trong hướng dẫn uỷ quyền, sau đó sử dụng yêu cầu HTTP GET sau đây:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
Bạn có thể xem phản hồi mẫu cho lệnh gọi API này.
Ví dụ sau đây truy xuất báo cáo về tất cả các sự kiện trên Drive trong 180 ngày qua (khoảng thời gian tối đa).
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
Truy xuất sự kiện trên Google Drive theo người dùng
Để truy xuất báo cáo về hoạt động của một người dùng cụ thể trên Google Drive, hãy sử dụng yêu cầu GET HTTP có mã thông báo uỷ quyền như mô tả trong hướng dẫn uỷ quyền.
Trường userKey là địa chỉ email chính của người dùng trong báo cáo hoặc all cho tất cả người dùng.
Ví dụ sau đây truy xuất một báo cáo liệt kê tất cả các thay đổi do người dùng được chỉ định thực hiện. Để xem ví dụ về phản hồi API, hãy xem phản hồi JSON mẫu.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive
Truy xuất sự kiện trên Google Drive cho bộ nhớ dùng chung
Bạn có thể truy xuất báo cáo về hoạt động trên Google Drive cho một ổ đĩa dùng chung cụ thể bằng cách sử dụng yêu cầu GET HTTP có mã thông báo uỷ quyền được mô tả trong hướng dẫn uỷ quyền. Chỉ định địa chỉ email của người dùng mà bạn muốn chạy báo cáo trong trường userKey hoặc chỉ định all để chạy báo cáo cho tất cả người dùng.
Ví dụ sau đây truy xuất báo cáo về tất cả các thay đổi đối với một ổ đĩa dùng chung cụ thể. Để xem ví dụ về phản hồi API, hãy xem phản hồi JSON mẫu.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>
Để truy xuất các sự kiện cho một bộ nhớ dùng chung, hãy lọc bằng cách sử dụng doc_type. Ví dụ sau đây truy xuất các sự kiện ảnh hưởng đến tất cả bộ nhớ dùng chung:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive
Để truy xuất các sự kiện cho những thay đổi về gói thành viên, hãy chỉ định shared_drive_membership_changeevent. Ví dụ sau đây truy xuất tất cả các lượt thêm thành viên vào bộ nhớ dùng chung:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive
Truy xuất sự kiện trên Google Drive theo loại sự kiện
Để truy xuất báo cáo về tất cả các phiên bản của một loại sự kiện cụ thể, chẳng hạn như tạo hoặc chỉnh sửa tài liệu, hãy sử dụng yêu cầu HTTP GET có mã thông báo uỷ quyền như mô tả trong hướng dẫn uỷ quyền.
Trường userKey là địa chỉ email chính của người dùng trong báo cáo hoặc all cho tất cả người dùng.
Ví dụ sau đây truy xuất một báo cáo về tất cả hoạt động tạo tài liệu tài khoản. Để xem ví dụ về phản hồi API, hãy xem phản hồi JSON mẫu:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create
Ví dụ về phản hồi JSON
Khi bạn đưa ra yêu cầu HTTP GET đến API, một phản hồi thành công sẽ trả về mã trạng thái HTTP 200. Cùng với mã trạng thái, phản hồi sẽ trả về một báo cáo cho Drive. Các báo cáo này cũng có trong bảng điều khiển dành cho quản trị viên. Để biết thêm thông tin, hãy xem Trung tâm trợ giúp dành cho Quản trị viên Google Workspace.
Để biết thông tin về eventName, hãy xem tài liệu tham khảo về tên sự kiện trên Drive. Để biết thêm thông tin về các chuỗi truy vấn của yêu cầu và các thuộc tính phản hồi, hãy xem Tài liệu tham khảo về API.
{
"kind": "reports#auditActivities",
"nextPageToken": "next page's token",
"items": [
{
"kind": "audit#activity",
"id": {
"time": "2014-03-17T15:39:18.460Z",
"uniqQualifier": "report's unique ID",
"applicationName": "drive",
"customerId": "ABC123xyz"
},
"actor": {
"callerType": "USER",
"email": "kim@example.com",
"profileId": "user's unique Google Workspace profile ID",
"key": "consumer key of requestor in an OAuth 2LO request"
},
"ownerDomain": "domain of the source owner",
"ipAddress": "user's IP address",
"events": [
{
"type": "access",
"name": "edit",
"parameters": [
{
"name": "primary_event",
"boolValue": true
},
{
"name": "owner_is_shared_drive",
"boolValue": false
}, {
"name": "doc_id",
"value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8"
},
{
"name": "doc_title",
"value": "Meeting notes"
},
{
"name": "doc_type",
"value": "document"
},
{
"name": "owner",
"value": "mary@example.com"
}
]
}
]
},
]
}