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.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 kỳ nơi nào mã tệp được cung cấ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 một thư mục, hãy dùng phương thức files.create
cùng với loại MIME application/vnd.google-apps.folder
và một 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
1.199
.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ã thư mục mẹ chứa tệp đó. 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
1.199
.NET
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.
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á 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ã 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
1.199
.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ố hạn mức bộ nhớ.
Giới hạn mục 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 các mục trong Drive lên 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 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 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 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
Các đối tượng không được tính vào hạn mức này là:
- Các 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 cố gắng thêm hơn 500 triệu mục, thì 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ặt hàng mà một tài khoản dịch vụ có thể sở hữu, nhưng giới hạn 500 triệu mặt hàng sẽ áp dụng cho số lượng mặt hàng mà một 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 phép có tối đa 500.000 mục. Giới hạn này không áp dụng cho thư mục gốc trong phần Drive của tôi. Các mục được tính vào hạn mức này là:
- Thư mục
- Tệp. Tất cả các loại tệp, bất kể chủ sở hữu tệp.
- Lối tắt. Đượ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 bài viết Tạo lối tắt đến 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 cho 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 bài viết Giới hạn thư mục trong Google Drive.
Giới hạn về 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 hơn 100 cấp thư mục lồng nhau. Điều này nghĩa là không thể lưu trữ thư mục con trong một thư mục sâu hơn 99 cấp. Giới hạn này chỉ áp dụng cho các 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ơ đồ dưới đây, một thư mục mới có thể được lồng bên trong thư mục số 99 nhưng không nằm 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 Drive khác:
Nếu cố gắng thêm hơn 100 cấp thư mục, thì hệ thống sẽ trả về phản hồi mã trạng thái HTTP myDriveHierarchyDepthLimitExceeded
.