API Google Drive cung cấp tài nguyên revisions để bạn có thể tải xuống và xuất bản các bản sửa đổi tệp. Để biết thêm thông tin chi tiết về thuật ngữ liên quan đến bản sửa đổi, hãy xem bài viết Tổng quan về các thay đổi và bản sửa đổi.
Hướng dẫn này giải thích cách quản lý các bản sửa đổi tệp bằng Google Drive API.
Chỉ định các bản sửa đổi cần lưu lại để không bị xoá tự động
Google Drive tự động xoá các phiên bản cũ mà người dùng không còn quan tâm nữa.
Bạn có thể đặt phiên bản sửa đổi tệp blob thành "Giữ vĩnh viễn", tức là phiên bản sửa đổi đó không thể bị xoá tự động. Bạn có thể đặt tối đa 200 phiên bản thành "Lưu giữ vĩnh viễn" và các phiên bản này sẽ được tính vào hạn mức bộ nhớ của bạn. Bản sửa đổi đầu không bao giờ được tự động xoá.
Mọi phiên bản tệp blob, ngoài phiên bản đầu, không được chỉ định là "Giữ vĩnh viễn" đều có thể bị xoá. 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à "Lưu giữ vĩnh viễn" và một bản sửa đổi mới được tải lên.
Bạn có thể đặt trường boolean keepForever của tài nguyên revisions thành true để đánh dấu những bản sửa đổi mà bạn không muốn Drive xoá. Sau khi được đặt thành "Giữ vĩnh viễn", bạn chỉ có thể tải xuống hoặc xoá bản sửa đổi tệp blob. Để biết thêm thông tin, hãy xem phần Tải một bản sửa đổi xuống hoặc Xoá một bản sửa đổi.
Tải một bản sửa đổi xuống
Bạn chỉ có thể tải các bản sửa đổi nội dung tệp blob được đánh dấu là "Giữ vĩnh viễn" xuống. Nếu bạn muốn tải một bản sửa đổi xuống, hãy nhớ đặt bản sửa đổi đó thành "Giữ vĩnh viễn" trước. Để biết thêm thông tin, hãy xem phần Chỉ định phiên bản cần lưu để không bị xoá tự động.
Để tải nội dung của tệp blob xuống hoặc xuất nội dung của tài liệu trên Google Workspace, hãy xem phần Tải xuống và xuất tệp.
Xoá một bản sửa đổi
Bạn có thể gọi phương thức revisions.delete để xoá vĩnh viễn một bản sửa đổi tệp blob, ngay cả khi bản sửa đổi đó được đánh dấu là "Giữ vĩnh viễn".
Nếu bạn đang sử dụng Drive API phiên bản 2 cũ, hãy sử dụng trường pinned của tài nguyên revisions.
Xuất bản bản sửa đổi
Để xuất bản một bản sửa đổi của Google Tài liệu, Google Trang tính và Google Trang trình bày, hãy đặt thuộc tính published cho tệp đó trong tài nguyên revisions. Bạn không thể đặt thuộc tính này cho các bản sửa đổi của Google Sites bằng Drive API.
Google Trang trình bày và Google Bản vẽ không hỗ trợ việc xuất bản các bản sửa đổi cụ thể. Chỉ hỗ trợ tự động xuất bản lại bản sửa đổi gần đây nhất. Để xuất bản Trang trình bày và Bản vẽ, hãy đặt publishAuto thành true.
Nếu tệp được tạo trong một miền Google Workspace, thì thuộc tính publishedOutsideDomain sẽ cho biết liệu mọi người có thể truy cập vào bản sửa đổi hay không hoặc liệu bản sửa đổi đó có bị hạn chế đối với người dùng trong miền hay không. Đối với tệp Sites, thuộc tính này cho biết liệu có quyền type=anyone hay không. Để biết thêm thông tin, hãy xem trường type trên tài nguyên permissions.
Các bản sửa đổi đã xuất bản không phản ánh những thay đổi đối với một tệp, trừ phi bạn đặt thuộc tính publishAuto. Nếu bạn đặt thuộc tính này thành true, các bản sửa đổi mới hơn của một tệp sẽ tự động được xuất bản, ghi đè các bản sửa đổi trước đó.
Slides và Drawings chỉ hỗ trợ tính năng tự động xuất bản lại và yêu cầu bạn đặt thuộc tính publishAuto thành true. Đối với tệp Sites, publishAuto luôn là false.
Tính năng tự động xuất bản cũng được kiểm soát bằng hộp đánh dấu "Tự động công bố lại khi có thay đổi" trong giao diện người dùng của Tài liệu và Trang tính. Để biết thêm thông tin, hãy xem bài viết Đặt tệp Google Tài liệu, Trang tính, Trang trình bày và Biểu mẫu ở chế độ công khai.