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. Các thuộc tính này có các thuộc tính sau:
- Thư mục là một tệp có loại MIME
application/vnd.google-apps.folder
và 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ã nhận dạng tệp.
Để biết thêm thông tin về giới hạn đối với thư mục trên Drive, hãy xem bài viết Giới hạn đối với 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ố thao tác 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 phương thức files.create
với loại MIME application/vnd.google-apps.folder
và tiêu đề. 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ã nhận dạng của thư mục mẹ chứa tệp.
Bạn có thể sử 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 có một thư mục mẹ; việc chỉ định nhiều thư mục mẹ sẽ không được hỗ trợ.
Mã mẫu sau đây cho biết cách tạo tệp trong một thư mục cụ thể bằng cách sử dụ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ã nhận dạng của thuộc tính parents
.
Để thêm hoặc xoá tệp mẹ cho một tệp hiện có, hãy sử dụng phương thức files.update
với các tham số truy vấn addParents
và removeParents
.
Một tệp chỉ có thể có một thư mục mẹ; không hỗ trợ việc chỉ định nhiều thư mục mẹ.
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
Các tệp và thư mục trên Drive có một số giới hạn về bộ nhớ.
Giới hạn về mặt hàng 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 hạn mức, 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 Đưa 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 hạn mức này bao gồm:
- 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 thuộc quyền sở hữu của người khác
- Các mục trong thùng rác
- Phím tắt
- Lối tắt của bên thứ ba
Sau đây là những đối tượng không được tính vào hạn mức này:
- Mục đã xoá vĩnh viễn
- Các mục được chia sẻ với người dùng này nhưng thuộc quyền sở hữu của người khác
- 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 mặc dù không có giới hạn về số lượng mục mà tài khoản dịch vụ có thể sở hữu, nhưng hạn mức 500 triệu mục áp dụng cho số lượng mục mà tài khoản dịch vụ có thể tạo.
Giới hạn số mục trong thư mục
Mỗi thư mục trong phần 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 hạn mức này bao gồm:
- Thư mục
- Tệp. Tất cả loại tệp, bất kể quyền sở hữu tệp.
- Lối tắt. Được tính là một mục trong thư mục, ngay cả khi mục mà tệp đó 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 một tệp trên Drive.
- Lối tắt của bên thứ ba. Được tính là một mục duy nhất trong thư mục, ngay cả khi mục mà mục đó trỏ đến không nằm trong thư mục đó. Để biết thêm thông tin, hãy xem phần Tạo tệp lối tắt đến nội dung do ứng dụng lưu trữ.
Để biết thêm thông tin về hạn mức thư mục, hãy xem bài viết Hạn mức thư mục trong Google Drive.
Giới hạn chiều sâu của thư mục
Phần Drive của tôi của người dùng không thể chứa nhiều hơn 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 thư mục có nhiều hơn 99 cấp độ. Quy định hạn chế này chỉ áp dụng cho thư mục con. Tệp con có loại MIME không phải application/vnd.google-apps.folder
sẽ được miễn giới hạn này.
Ví dụ: trong sơ đồ sau, bạn có thể lồng một 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ữ các tệp như mọi thư mục 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 HTTP myDriveHierarchyDepthLimitExceeded
.