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 hoạt độ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 để lấy một danh sách trong tất cả tài liệu Drive mới do một người dùng cụ thể tạo trong phạm vi ngày được chỉ định. Bạn có thể sử dụng thông tin này để thu thập thông tin chi tiết về quản lý nội dung hiệu quả hơn và có nguy cơ rò rỉ dữ liệu. Để nhận báo cáo, bạn 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ố dành riêng cho báo cáo 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.
Chỉ có thể sử dụng báo cáo hoạt động trên Google Drive cho các mục đích hợp pháp trong các tài khoản mà được cấp giấy phép.
Để biết thông tin về các chuỗi truy vấn và thuộc tính phản hồi, hãy xem Tài liệu tham khảo API. Cho thông tin về các sự kiện cụ thể liên quan đến Google Drive, xem Tên sự kiện trên Drive.
Truy xuất 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ề
Tài liệu Drive. Ví dụ: bạn có thể yêu cầu một danh sách báo cáo
25 sự kiện Drive gần đây nhất trong tài khoản của bạn, bao gồm tối đa 180 sự kiện
ngày. Để nhận báo cáo này, hãy lấy mã thông báo uỷ quyền như được mô tả trong
hướng dẫn uỷ quyền, sau đó sử dụng
yêu cầu HTTP GET sau:
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 của tất cả Drive sự kiện trong 180 ngày qua, đây là 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 trên Google Drive của một người dùng cụ thể, hãy sử dụng
Yêu cầu HTTP GET có mã thông báo uỷ quyền được mô tả trong
hướng dẫn về 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 truy xuất một báo cáo liệt kê tất cả các thay đổi được thực hiện bởi người dùng được chỉ định. Để biết ví dụ về phản hồi của 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 tệp được chia sẻ cụ thể
lái xe bằng cách sử dụng yêu cầu HTTP GET với 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ả thay đổi cho một URL cụ thể được chia sẻ Drive. Để biết 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 trong một bộ nhớ dùng chung, hãy lọc bằng doc_type. Chiến lược phát hành đĩa đơn
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 sự kiện đối với những thay đổi về gói thành viên, hãy chỉ định shared_drive_membership_change
sự kiện. Ví dụ sau đây truy xuất tất cả thành viên đã thêm 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 lần xuất hiệ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ó yêu cầu uỷ quyền
mã thông báo được 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 báo cáo về toàn bộ hoạt động tạo tài liệu tài khoản hoạt động. Để biết 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 gửi một yêu cầu HTTP GET đến API, một phản hồi thành công sẽ trả về một
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ên sự kiện trên Drive
tham chiếu. Để biết thêm thông tin về 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 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"
}
]
}
]
},
]
}