Google Drive duy trì nhật ký sửa đổi tự động, có thể giúp người dùng theo dõi các thay đổi đối với tệp và bản sửa đổi nội dung. Trong nhật ký sửa đổi, người dùng có thể xem nội dung chỉnh sửa đã thực hiện và có thể quay lại một phiên bản cụ thể của tệp có nội dung chỉnh sửa cụ thể.
Các điều khoản sau đây có liên quan đến các thay đổi và tài nguyên sửa đổi của API Google Drive:
- Danh sách kiểm soát quyền truy cập (ACL)
- Danh sách tất cả tài nguyên quyền được liên kết với một tệp, thư mục hoặc ổ đĩa dùng chung.
- Thay đổi
- Sự thay đổi đối với nội dung hoặc siêu dữ liệu của tệp hoặc bộ nhớ dùng chung.
- Nhật ký thay đổi của người dùng
- Bản ghi tất cả thay đổi mà người dùng đã thực hiện đối với mọi tệp có thể chỉnh sửa trong thư mục Drive của tôi, chẳng hạn như tệp Google Tài liệu, Trang tính hoặc Trang trình bày. Đối với các thành viên của bộ nhớ dùng chung, nhật ký thay đổi của người dùng cũng bao gồm các mục về tư cách thành viên của bộ nhớ dùng chung, cấp truy cập của người dùng vào các mục trong bộ nhớ dùng chung đó và các thay đổi về tên của bộ nhớ dùng chung.
- Nhật ký thay đổi về bộ nhớ dùng chung
- Bản ghi tất cả thay đổi đối với một bộ nhớ dùng chung, chẳng hạn như thêm hoặc xoá người dùng và tất cả thay đổi đối với các mục trên bộ nhớ dùng chung đó. Thay đổi đối với một mục trong bộ nhớ dùng chung sẽ xuất hiện trong cả nhật ký thay đổi của người dùng và nhật ký thay đổi của bộ nhớ dùng chung.
- Mục nhật ký thay đổi
- Bản ghi về thay đổi đối với nội dung hoặc siêu dữ liệu của tệp hoặc ổ đĩa dùng chung. Mục nhập nhật ký thay đổi cho biết người dùng đã thực hiện thay đổi, dấu thời gian và mã nhận dạng. Mỗi tệp hoặc bộ nhớ dùng chung chỉ có thể có một mục nhập trong nhật ký thay đổi tại một thời điểm. Mỗi lần tệp hoặc bộ nhớ dùng chung đó thay đổi, một mã nhận dạng mới sẽ được tạo cho mục nhập đó và thay thế cho mục nhập trước đó.
- Bản sửa đổi
- Phiên bản của tệp đại diện cho một thay đổi đối với nội dung của tệp (không phải siêu dữ liệu). Bạn có thể truy cập vào từng bản sửa đổi bằng cách sử dụng tài nguyên Bản sửa đổi trong API Drive.
- Bản sửa đổi chính
- Phiên bản mới nhất của tệp.
- Bản sửa đổi blob
Một phiên bản của tệp nhị phân không thể sửa đổi, chẳng hạn như hình ảnh, video hoặc PDF. Nếu bản sửa đổi blob là bản sửa đổi duy nhất của tệp nhị phân, thì bạn không thể xoá tệp đó. Bạn có thể tải một blob mới lên dưới dạng một bản sửa đổi mới. Bản sửa đổi này sẽ trở thành bản sửa đổi đầu mới của tệp đó.
Bạn có thể đặt các bản sửa đổi blob thành "Giữ mãi mãi", nghĩa là bản sửa đổi không thể được xoá tự động. Bạn có thể đặt tối đa 200 bản sửa đổi thành "Giữ vĩnh viễn". Bản sửa đổi giao diện người dùng không bao giờ tự động xoá hoàn toàn.
Bạn có thể xoá mọi bản sửa đổi (ngoại trừ bản sửa đổi chính) không được chỉ định là "Giữ mãi mãi". Các bản sửa đổi có thể xoá thường được lưu giữ trong 30 ngày, nhưng có thể bị xoá sớm hơn nếu một tệp có 100 bản sửa đổi không được chỉ định là "Giữ mãi mãi" và một bản sửa đổi mới được tải lên.
Trường
keepForever
của tài nguyênRevisions
được dùng để đặt bản sửa đổi thành "Giữ mãi mãi". Ngoài ra, bạn có thể gọirevisions.delete
để xoá một bản sửa đổi ngay cả khi bản sửa đổi đó được đánh dấu là "Giữ vĩnh viễn".- Nhật ký sửa đổi
Bản ghi tất cả các bản sửa đổi của một tệp theo thứ tự thời gian. Mỗi lần thay đổi đối với tệp Tài liệu, Trang tính hoặc Trang trình bày sẽ tạo ra một bản sửa đổi mới. Mỗi khi nội dung thay đổi, Drive sẽ tạo một mục nhập mới trong nhật ký sửa đổi cho tệp đó. Tuy nhiên, các bản sửa đổi tệp của trình chỉnh sửa này có thể được hợp nhất với nhau, vì vậy, phản hồi API có thể không hiển thị tất cả thay đổi đối với một tệp.
Xem video này để tìm hiểu cách quản lý các bản sửa đổi bằng API Google Drive:
Các bước tiếp theo
- Để xác định vị trí ghi lại thay đổi mà bạn muốn theo dõi, hãy xem phần Xác định nhật ký thay đổi cần theo dõi.
- Để thiết lập tính năng theo dõi thay đổi cho người dùng và bộ nhớ dùng chung, hãy xem bài viết Theo dõi các thay đổi đối với người dùng và bộ nhớ dùng chung.
- Để xuất bản, tải xuống hoặc truy vấn bản sửa đổi, hãy xem phần Tải xuống và xuất bản bản sửa đổi tệp.
- Để thiết lập thông báo thay đổi, hãy xem phần Thông báo đẩy.