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