Tài liệu này cung cấp thông tin tổng quan về Google Drive Activity API.
Drive Activity API cho phép bạn truy vấn các sự kiện gần đây. Bạn có thể tìm nạp nhật ký chi tiết về tất cả hoạt động, bao gồm cả thông tin chi tiết về từng sự kiện. Điều này rất hữu ích cho các tác vụ như kiểm tra vì bạn có thể truy xuất các hoạt động chính xác bao gồm thông tin ActionDetail, Actor và Target.
Drive Activity API bao gồm tài nguyên DriveActivity, đại diện cho những thay đổi đối với các đối tượng trong Google Drive của người dùng và phương thức activity.query, cho phép bạn truy xuất thông tin về những thay đổi đó.
Yêu cầu
Ứng dụng của bạn yêu cầu dữ liệu hoạt động của người dùng bằng phương thức activity.query. Bạn có thể yêu cầu thông tin về hoạt động của một mục cụ thể trên Drive hoặc mọi thứ có trong một thư mục trên Drive. Đối với một yêu cầu nhất định, bạn có thể chọn hạn chế phản hồi bằng cách sử dụng một bộ lọc, chẳng hạn như phạm vi thời gian hoặc loại hành động, đồng thời bạn có thể chọn hợp nhất hoạt động trong phản hồi. Để biết thêm thông tin, hãy xem phần Đưa ra yêu cầu trong API Hoạt động trên Google Drive.
Phản hồi
Phản hồi chứa danh sách các hoạt động khớp với các tham số đã cho, trong đó tài nguyên DriveActivity đại diện cho từng hoạt động:
Tài nguyên DriveActivity là một tập hợp các đối tượng Action, mỗi đối tượng là một đối tượng độc lập như một sự kiện. Action bao gồm một ActionDetail (chẳng hạn như Create hoặc Edit), một Actor (chẳng hạn như User hoặc Administrator), một Target (chẳng hạn như DriveItem hoặc Drive) và một Timestamp hoặc TimeRange.
Tài nguyên DriveActivity cũng chứa thông tin tóm tắt, chẳng hạn như mọi Actor và Target từ tất cả các hành động, Timestamp hoặc TimeRange hợp nhất và ActionDetail quan trọng nhất hoặc mang tính đại diện nhất của Action.
Để biết thêm thông tin, hãy xem mô hình dữ liệu Drive Activity API.
Chế độ hiển thị nhật ký hoạt động
Một số hoạt động trên Drive có thể không được báo cáo khi bạn sử dụng Drive Activity API. Việc API báo cáo một thay đổi nhất định đối với một đối tượng hay không phụ thuộc vào việc thay đổi đó hoặc thông tin về thay đổi đó có hiển thị cho người dùng đã xác thực trong ứng dụng của bạn hay không.
Khả năng hiển thị dựa trên các quyền được đặt cho đối tượng. Có một số trường hợp khi tệp và thư mục được chia sẻ trong Drive:
Nếu tác giả chia sẻ tài liệu, thì cả người tạo và người dùng được chia sẻ tài liệu đều có thể xem nhật ký hoạt động của tài liệu đó.
Nếu một tài liệu được chia sẻ với người dùng rồi chuyển sang chế độ riêng tư, thì người dùng đó có thể xem toàn bộ nhật ký hoạt động từ thời điểm họ có quyền truy cập, nhưng không thể xem sau khi quyền bị hạn chế.
Nếu một tài liệu chưa từng được chia sẻ với người dùng, thì người dùng đó sẽ không thấy nhật ký hoạt động nào.
Chủ đề có liên quan
- Để khai thác tối đa API Hoạt động trong Drive, trước tiên, hãy tích hợp ứng dụng của bạn với API Google Drive
- Để tìm hiểu về cách phát triển bằng các API của Google Workspace, bao gồm cả việc tạo dự án hoặc xử lý quy trình xác thực và uỷ quyền, hãy tham khảo phần Phát triển trên Google Workspace.
- Để tìm hiểu về các hoạt động, hãy xem tài liệu tham khảo về API.