API Hoạt động trên Google Drive bao gồm tài nguyên DriveActivity, đại diện cho các thay đổi được thực hiện đố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 cách sử dụng phương thức activity.query. Bạn có thể yêu cầu xem hoạt động của một mục cụ thể trên Drive hoặc của mọi mục trong một thư mục trên Drive. Đối với một yêu cầu cụ thể, bạn có thể chọn hạn chế phản hồi theo các quy tắc ràng buộc 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 Thực hiện yêu cầu trong Drive Activity API.
Phản hồi
Phản hồi cho yêu cầu là 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 đều độc lập như một sự kiện. Action bao gồm ActionDetail (chẳng hạn như Create hoặc Edit), Actor (chẳng hạn như User hoặc Administrator), Target (chẳng hạn như DriveItem hoặc Drive) và 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, một Timestamp hoặc TimeRange hợp nhất và ActionDetail quan trọng nhất hoặc đại diện của Action.
Để biết thêm thông tin, hãy xem mô hình dữ liệu API Hoạt động trên Drive.
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 API này. Việc API Hoạt động trên Drive có 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 người dùng đã xác thực trong ứng dụng của bạn có thấy thay đổi hoặc thông tin về thay đổi đó hay không.
Mức độ 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ẻ một tài liệu, thì nhật ký hoạt động của tài liệu đó không chỉ hiển thị với người tạo mà còn cho những người dùng đã xác thực được chia sẻ 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 đã xác thực có thể xem tất cả nhật ký hoạt động trong khi họ có quyền truy cập và các quyền đó hiệ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.
Bắt đầu
Để khai thác tối đa Drive Activity API, trước tiên, hãy tích hợp ứng dụng của bạn với API Google Drive. Để bắt đầu sử dụng Drive Activity API, hãy tìm hiểu cách tạo dự án và uỷ quyền các yêu cầu. Hoặc bạn có thể tìm hiểu ngay và đọc về các hoạt động trong tài liệu tham khảo API.