Thư mục là các tệp chỉ chứa siêu dữ liệu và có thể dùng để sắp xếp các tệp trong Google Drive. Chúng có các thuộc tính sau:
- Thư mục là một tệp có loại MIME
application/vnd.google-apps.foldervà không có đuôi. - Bạn có thể dùng bí danh
rootđể tham chiếu đến thư mục gốc ở bất cứ nơi nào có mã tệp.
Để biết thêm thông tin về giới hạn thư mục trên Drive, hãy xem bài viết Giới hạn về tệp và thư mục.
Hướng dẫn này giải thích cách thực hiện một số tác vụ cơ bản liên quan đến thư mục.
Tạo thư mục
Để tạo thư mục, hãy sử dụng files.create()
phương thức với mimeType là application/vnd.google-apps.folder và name.
Đoạn mã mẫu sau đây cho biết cách tạo thư mục bằng thư viện ứng dụng:
Java
Python
Node.js
PHP
.NET
Tạo tệp trong một thư mục cụ thể
Để tạo tệp trong một thư mục cụ thể, hãy sử dụng phương thức files.create() và chỉ định mã thư mục trong thuộc tính
parents của tệp.
Thuộc tính parents chứa mã của thư mục mẹ chứa tệp.
Bạn có thể dùng thuộc tính parents khi tạo tệp trong thư mục cấp cao nhất hoặc bất kỳ thư mục nào khác.
Một tệp chỉ có thể có một thư mục mẹ. Hệ thống không hỗ trợ việc chỉ định nhiều thư mục mẹ. Nếu bạn không chỉ định trường parents, tệp sẽ được đặt trực tiếp vào thư mục Drive của tôi của người dùng.
Đoạn mã mẫu sau đây cho biết cách tạo tệp trong một thư mục cụ thể bằng thư viện ứng dụng:
Java
Python
Node.js
PHP
.NET
Di chuyển tệp giữa các thư mục
Để di chuyển tệp, bạn phải cập nhật mã của thuộc tính parents.
Để thêm hoặc xoá thư mục mẹ cho một tệp hiện có, hãy sử dụng phương thức files.update() với tham số truy vấn addParents và
removeParents.
Một tệp chỉ có thể có một thư mục mẹ. Hệ thống không hỗ trợ việc chỉ định nhiều thư mục mẹ.
Đoạn mã mẫu sau đây cho biết cách di chuyển tệp giữa các thư mục bằng thư viện ứng dụng:
Java
Python
Node.js
PHP
.NET
Giới hạn về tệp và thư mục
Tệp và thư mục trên Drive có một số giới hạn về dung lượng lưu trữ.
Giới hạn về số mục của người dùng
Mỗi người dùng có thể có tối đa 500 triệu mục do tài khoản đó tạo. Khi đạt đến giới hạn, người dùng sẽ không thể tạo hoặc tải mục lên Drive nữa. Họ vẫn có thể xem và chỉnh sửa các mục hiện có. Để tạo lại tệp, người dùng phải xoá vĩnh viễn các mục hoặc sử dụng một tài khoản khác. Để biết thêm thông tin, hãy xem bài viết Chuyển tệp và thư mục vào thùng rác hoặc xoá tệp và thư mục.
Các đối tượng được tính vào giới hạn này là:
- Các mục do người dùng tạo hoặc tải lên trong Drive
- Các mục do người dùng tạo nhưng hiện do người khác sở hữu
- Các mục trong thùng rác
- Phím tắt
- Phím tắt của bên thứ ba
Các đối tượng không được tính vào giới hạn này là:
- Các mục đã bị xoá vĩnh viễn
- Các mục được chia sẻ với người dùng nhưng do người khác sở hữu
- Các mục do người dùng sở hữu nhưng do người khác tạo
Nếu bạn cố gắng thêm hơn 500 triệu mục, hệ thống sẽ trả về phản hồi mã trạng thái HTTP
activeItemCreationLimitExceeded.
Xin lưu ý rằng tài khoản dịch vụ không thể sở hữu bất kỳ tệp nào. Thay vào đó, tài khoản dịch vụ phải tải tệp và thư mục lên bộ nhớ dùng chung hoặc sử dụng OAuth 2.0 để tải các mục lên thay mặt người dùng.
Giới hạn về số mục của thư mục
Mỗi thư mục trong Drive của tôi của người dùng có giới hạn là 500.000 mục. Giới hạn này không áp dụng cho thư mục gốc của Drive của tôi. Các mục được tính vào giới hạn này là:
- Thư mục
- Tệp. Tất cả các loại tệp, bất kể quyền sở hữu tệp.
- Phím tắt. Được tính là một mục trong thư mục, ngay cả khi mục đó trỏ đến không nằm trong thư mục đó. Để biết thêm thông tin, hãy xem bài viết Tạo lối tắt đến tệp trên Drive.
- Phím tắt của bên thứ ba. Được tính là một mục trong thư mục, ngay cả khi mục đó trỏ đến không nằm trong thư mục đó. Để biết thêm thông tin, hãy xem bài viết Tạo tệp lối tắt đến nội dung do ứng dụng của bạn lưu trữ.
Để biết thêm thông tin về giới hạn thư mục, hãy xem Giới hạn về thư mục trong Google Drive.
Giới hạn về độ sâu của thư mục
Drive của tôi của người dùng không thể chứa quá 100 cấp thư mục lồng nhau. Điều này có nghĩa là bạn không thể lưu trữ thư mục con trong một thư mục có độ sâu hơn 99 cấp. Giới hạn này chỉ áp dụng cho thư mục con. Tệp con
có loại MIME khác
application/vnd.google-apps.folder được miễn giới hạn này.
Ví dụ: trong sơ đồ sau, bạn có thể lồng thư mục mới bên trong thư mục số 99 nhưng không thể lồng bên trong thư mục số 100. Tuy nhiên, thư mục số 100 có thể lưu trữ tệp như bất kỳ thư mục nào khác trên Drive:
Nếu bạn cố gắng thêm hơn 100 cấp thư mục, hệ thống sẽ trả về phản hồi mã trạng thái
myDriveHierarchyDepthLimitExceeded
HTTP.