Chuyển vào thùng rác hoặc xoá tệp và thư mục

Bạn có thể xoá các tệp và thư mục trên Google Drive khỏi cả thư mục và tệp Drive và bộ nhớ dùng chung. Bạn có hai tuỳ chọn để thực hiện việc này: chuyển vào thùng rác hoặc xoá.

Bạn có thể di chuyển các tệp và thư mục vào thùng rác rồi khôi phục chúng (trong vòng 30 ngày ngày chuyển chúng vào thùng rác). Thao tác xoá các tệp và thư mục sẽ xoá vĩnh viễn các tệp và thư mục đó khỏi Drive. Nếu bạn chuyển nhiều mục vào thùng rác, khôi phục hoặc xoá vĩnh viễn nhiều mục tệp hoặc thư mục cùng một lúc, thì có thể mất một lúc bạn mới nhận thấy sự thay đổi.

Hướng dẫn này giải thích cách bạn có thể vứt bỏ tệp trong Drive.

Thùng rác

Để xoá tệp trên Drive, bạn có thể di chuyển các tệp đó vào thùng rác. Tệp trong thùng rác sẽ tự động bị xoá sau 30 ngày. Bạn có thể khôi phục tệp từ thùng rác của bạn trước khoảng thời gian 30 ngày.

Chỉ chủ sở hữu tệp mới có thể chuyển tệp vào thùng rác, còn những người dùng khác không thể xem tệp trong thùng rác của chủ sở hữu. Nếu bạn cố gắng chuyển một tệp mình không sở hữu vào thùng rác, bạn sẽ nhận được insufficientFilePermissions . Để biết thêm thông tin, hãy xem bài viết Quyền.

Để xác minh bạn là chủ sở hữu tệp, hãy gọi Phương thức files.get với fileId và tham số fields được đặt thành trường boolean ownedByMe. ownedByMe không được điền sẵn cho các tệp trong bộ nhớ dùng chung vì các tệp đó thuộc sở hữu của bộ nhớ dùng chung, chứ không phải người dùng cá nhân. Để biết thêm thông tin về việc trả lại các trường bằng cách sử dụng tham số fields, hãy xem phần Trả về các trường cụ thể cho .

Nếu bạn không phải là chủ sở hữu tệp nhưng vẫn muốn có bản sao của tệp đã chuyển vào thùng rác, hãy tạo một bản sao trong số sau:

  • Tạo bản sao cho tệp.
  • Liên hệ với chủ sở hữu để yêu cầu họ khôi phục tệp từ thùng rác.

Chuyển tệp vào thùng rác

Để chuyển một tệp vào thùng rác, hãy sử dụng files.update và đặt giá trị trashed đến True. Để chuyển một tệp trong bộ nhớ dùng chung vào thùng rác, bạn cũng phải đặt supportsAllDrives tham số truy vấn thành True. Để biết thêm thông tin, hãy xem Triển khai tính năng hỗ trợ bộ nhớ dùng chung.

Nếu thành công, phản hồi body chứa thực thể của tài nguyên tệp.

Mã mẫu sau đây cho biết cách sử dụng fileId để đánh dấu tệp là đã chuyển vào thùng rác:

Python

body_value = {'trashed': True}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

Node.js

const body_value = {
  'trashed': True
};

const response = await drive_service.files.update({
      fileId: 'FILE_ID',
      requestBody: body_value,
    });
    return response;

Thay thế FILE_ID bằng fileId của tệp mà bạn muốn chuyển vào thùng rác.

Xác định các thuộc tính của một tệp được chuyển vào thùng rác

Khi một tệp bị chuyển vào thùng rác, bạn có thể truy xuất thêm Thuộc tính files. Bạn có thể sử dụng files.get và bao gồm phương thức các trường sau trong tham số fields. Để biết thêm thông tin, hãy xem bài viết Trả bài các trường cụ thể cho một tệp.

Sau đây là các trường được điền sẵn cho tất cả các tệp:

  • trashed: Liệu tệp có bị chuyển vào thùng rác hay không, dù là từ một mục rõ ràng hay từ một thùng rác thư mục mẹ. Xin lưu ý rằng trong khi sử dụng trashed với files.update phương thức đặt trạng thái của tệp, phương thức files.get sẽ truy xuất trạng thái của tệp trạng thái.
  • explicitlyTrashed: Liệu tệp có bị chuyển vào thùng rác rõ ràng hay không, chứ không phải là đã chuyển vào thùng rác chuyển vào thùng rác định kỳ từ thư mục mẹ.

Các trường sau đây chỉ được điền sẵn cho những tệp nằm trong bộ nhớ dùng chung:

  • trashedTime: Thời gian mục được chuyển vào thùng rác theo định dạng RFC 3339 định dạng ngày giờ. Nếu bạn đang sử dụng API Drive phiên bản 2 trước đây phiên bản, trường này được gọi là trashedDate.
  • trashingUser: Nếu tệp đã bị chuyển vào thùng rác một cách rõ ràng, thì tức là người dùng đã chuyển tệp đó vào thùng rác.

Khôi phục tệp từ thùng rác

Để khôi phục tệp từ thùng rác, hãy sử dụng files.update và đặt giá trị trashed đến False. Để khôi phục tệp trong bộ nhớ dùng chung vào thùng rác, bạn cũng phải đặt tham số truy vấn supportsAllDrives vào True. Để biết thêm thông tin, hãy xem Triển khai tính năng hỗ trợ bộ nhớ dùng chung.

Nếu thành công, phản hồi body chứa thực thể của tài nguyên tệp.

Mã mẫu sau đây cho biết cách sử dụng fileId để đánh dấu tệp là đã khôi phục:

Python

body_value = {'trashed': False}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

Node.js

const body_value = {
  'trashed': False
};

const response = await drive_service.files.update({
      fileId: 'FILE_ID',
      requestBody: body_value,
    });
    return response;

Thay thế FILE_ID bằng fileId của tệp mà bạn muốn khôi phục.

Dọn sạch thùng rác

Bạn có thể xoá vĩnh viễn tất cả các tệp trên Drive mà người dùng đã di chuyển vào thùng rác bằng tính năng files.emptyTrash. Người nhận dọn sạch thùng rác của một bộ nhớ dùng chung, bạn cũng phải đặt truy vấn driveId với mã bộ nhớ dùng chung.

Nếu thành công, phản hồi body chứa khoảng trống thực thể.

Mã mẫu sau đây cho biết cách dùng fileId để xoá tất cả tệp trong thùng rác:

Python

response = drive_service.files().emptyTrash().execute()

Node.js

 const response = await drive_service.files.emptyTrash({
    });
    return response;

Xoá

Bạn có thể xoá vĩnh viễn một tệp trên Drive mà không cần di chuyển tệp đó sang chuyển vào thùng rác. Sau khi bạn xoá một tệp, những người mà bạn đã chia sẻ tệp đó sẽ mất quyền truy cập vào ứng dụng. Nếu muốn người khác giữ quyền truy cập vào tệp, bạn có thể chuyển quyền sở hữu thành người khác trước khi xoá.

Để xoá một tệp trong bộ nhớ dùng chung, người dùng phải có role=organizer trong thư mục mẹ . Nếu bạn đang xoá một thư mục, tất cả các thư mục con mà người dùng sở hữu cũng sẽ đã bị xoá. Để biết thêm thông tin, hãy xem bài viết Quyền.

Để xóa vĩnh viễn một tệp do người dùng sở hữu mà không chuyển tệp đó vào thùng rác, hãy sử dụng Phương thức files.delete. Để xoá một tệp trong bộ nhớ dùng chung, bạn cũng phải đặt tham số truy vấn supportsAllDrives thành True. Để biết thêm thông tin, hãy xem bài viết Triển khai bộ nhớ dùng chung .

Nếu thành công, phản hồi body chứa thực thể trống.

Mã mẫu sau đây cho biết cách dùng fileId để xoá tệp:

Python

response = drive_service.files().delete(fileId="FILE_ID").execute()

Node.js

 const response = await drive_service.files.delete({
      fileId: 'FILE_ID'
    });
    return response;

Thay thế FILE_ID bằng fileId của tệp mà bạn muốn xoá.

Quyền

Bảng sau đây trình bày các quyền theo vai trò cần thiết để thực hiện mỗi hoạt động. Để biết danh sách đầy đủ các vai trò và hoạt động được phép mỗi vai trò, tham khảo Vai trò và quyền.

Thao tác được phép owner organizer fileOrganizer writer commenter reader
Chuyển tệp và thư mục vào thùng rác
Khôi phục tệp và thư mục từ thùng rác
Dọn sạch thùng rác
Xoá vĩnh viễn tệp hoặc thư mục
Xoá các tệp và thư mục trong bộ nhớ dùng chung [*]

Tính năng

Tài nguyên files chứa một tập hợp của các trường boolean capabilities dùng để cho biết liệu có thể thực hiện một hành động hay không đã thực hiện trên một tệp.

Để kiểm tra các chức năng, hãy gọi Phương thức files.get với fileId và tham số fields được đặt thành trường capabilities. Để biết thêm thông tin về việc trả về các trường bằng cách sử dụng tham số fields, xem phần Trả về các trường cụ thể cho một tệp.

Sau đây là các trường được điền sẵn cho tất cả các tệp:

  • capabilities.canTrash: Người dùng hiện tại có thể di chuyển tệp này sang hay không chuyển vào thùng rác.
  • capabilities.canUntrash: Liệu người dùng hiện tại có thể khôi phục tệp này hay không khỏi thùng rác.
  • capabilities.canDelete: Liệu người dùng hiện tại có thể xoá tệp này hay không.
  • capabilities.canRemoveChildren: Liệu người dùng hiện tại có thể xoá hay không phần tử con khỏi thư mục này. Giá trị này là false khi mục không phải là thư mục.

Các trường sau đây chỉ được điền sẵn cho những tệp nằm trong bộ nhớ dùng chung:

  • capabilities.canTrashChildren: Liệu người dùng hiện tại có thể chuyển trẻ em vào thùng rác hay không của thư mục này. Giá trị này là false khi mục không phải là thư mục.
  • capabilities.canDeleteChildren: Liệu người dùng hiện tại có thể xoá hay không con của thư mục này. Giá trị này là false khi mục không phải là thư mục.

Giới hạn về tệp và thư mục

Các tệp và thư mục trên Drive, cùng với các thư mục trong bộ nhớ dùng chung, có một số hạn mức bộ nhớ.

Thông thường, sau khi đạt đến hạn mức mục, cách duy nhất để tạo thêm không gian là để xoá vĩnh viễn các mục hoặc dùng một tài khoản khác. Việc chuyển các tệp vào thùng rác là không đủ để giải phóng dung lượng.

Để biết thêm thông tin về giới hạn đối với tệp và thư mục, hãy xem các phần sau: