API Google Drive cung cấp tài nguyên Bản sửa đổi để 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ữ của 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.
Chỉ định các bản sửa đổi để lưu từ thao tác xoá tự động
Google Drive tự động xoá các bản sửa đổi cũ hơn mà người dùng không còn quan tâm. Để ngăn điều này xảy ra, bạn có thể thiết lập cờ boolean keepRevisionForever thành true để đánh dấu các bản sửa đổi mà bạn không muốn Drive xoá hoàn toàn.
Tải bản sửa đổi xuống
Bạn có thể sử dụng giá trị của trường headRevisionId từ tài nguyên Tệp để tải xuống bản sửa đổi mới nhất.
Thao tác này sẽ tìm nạp bản sửa đổi tương ứng với siêu dữ liệu của tệp bạn đã truy xuất trước đây. Để tải dữ liệu của tất cả bản sửa đổi trước đó của tệp vẫn được lưu trữ trên đám mây, bạn có thể gọi revisions.list để nhận tất cả mã phiên bản.
Để tải nội dung bản sửa đổi xuống, bạn cần gọi
revisions.get với tham số alt=media. Bạn không thể tải các bản sửa đổi dành cho Google Tài liệu, Trang tính và Trang trình bày xuống.
Các bản sửa đổi Google Tài liệu, Google Bản vẽ và Trang trình bày tự động tăng số bản sửa đổi. Tuy nhiên, chuỗi số có thể bị thiếu hụt nếu các bản sửa đổi bị xoá. Vì vậy, bạn không nên dựa vào số thứ tự khi truy xuất các bản sửa đổi.
Xuất bản bản sửa đổi
Để xuất bản một bản sửa đổi trên Google Tài liệu, Trang tính và Trang trình bày, bạn cần đặt thuộc tính published cho tệp đó trong thuộc tính Bản sửa đổi. Không thể đặt thuộc tính này cho các bản sửa đổi Google Sites thông qua API Drive.
Nếu tệp được tạo trong miền Google Workspace ,
thuộc tính publishedOutsideDomain cho biết liệu bản sửa đổi
có thể truy cập được bởi bất kỳ ai hoặc nếu trang web bị giới hạn đối với người dùng của miền. Đối với Google
Các tệp trên Sites, thuộc tính này cho biết liệu có quyền type=anyone hay không.
Các bản sửa đổi đã xuất bản không phản ánh những thay đổi đối với tệp, trừ phi bạn đặt thuộc tính publishAuto. Nếu bạn đặt thuộc tính đó thành true, thì các bản sửa đổi mới hơn của tệp sẽ tự động được xuất bản, ghi đè lên các bản sửa đổi trước đó. Hành vi này cũng được kiểm soát bởi chế độ "Tự động xuất bản lại khi có các thay đổi" trong giao diện người dùng Drive. Đối với các tệp trên Google Sites, publishAuto luôn là false.