Google Drive Activity API bao gồm
Tài nguyên DriveActivity
thể hiện 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à
activity.query, cho phép bạn truy xuất
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 hoạt động
cho một mục cụ thể trên Drive hoặc mọi nội dung có trong 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
giới hạn như phạm vi thời gian hoặc loại hành động,
có thể chọn hợp nhất hoạt động trong
của bạn. Để 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
Action, mỗi đối tượng
độ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
chẳng hạn như mỗi
Actor và
Target từ tất cả các thao tác, một tính năng hợp nhất
Timestamp
hoặc TimeRange và lựa chọn phổ biến nhất
quan trọng hoặc mang tính đại diện
ActionDetail/
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 API này. Liệu Drive Activity API báo cáo một thay đổi nhất định đối với một đối tượng phụ thuộc vào việc thay đổi hoặc thông tin về thay đổi đó sẽ hiển thị cho người dùng trong ứng dụng của bạn.
Chế độ hiển thị dựa trên quyền được đặt cho đối tượng. Có một vài các 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ì nhật ký hoạt động của tài liệu đó không chỉ hiển thị cho nhà sáng tạo mà còn cho người dùng đã xác thực được chia sẻ với ai.
- 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ì tài liệu đã được xác thực người dùng có thể xem tất cả nhật ký hoạt động trong khi họ có quyền truy cập và rằng các quyền hiện tại bị hạn chế.
- Nếu 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ể nhìn thấy bất kỳ hoạt động nào nhật ký.
Bắt đầu
Để khai thác tối đa Drive Activity API, hãy tích hợp ứng dụng của bạn với API Google Drive trước tiên. Để bắt đầu sử dụng Drive Activity API, tìm hiểu cách tạo dự án và các yêu cầu uỷ quyền. Hoặc, đi thẳng vào và đọc về các hoạt động trong Tài liệu tham khảo API.