Thư mục là những 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 là
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 bạn cung cấp mã nhận dạng tệp.
Để biết thêm thông tin về giới hạn thư mục trên Drive, hãy xem phần 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ố 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 sử dụng phương thức files.create()
với mimeType
của application/vnd.google-apps.folder
và name
.
Mã mẫu sau đây cho biết cách tạo một 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 một 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ã nhận dạng thư mục trong thuộc tính parents
của tệp.
Thuộc tính parents
lưu giữ 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ó thể có một thư mục mẹ. Bạn không thể chỉ định nhiều tài khoản 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ã sau đây minh hoạ cách tạo một tệp trong một thư mục cụ thể bằng cách dùng một 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á 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ẹ. Bạn không thể chỉ định nhiều tài khoản mẹ.
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 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ố hạn mức lưu trữ.
Giới hạn về số lượng người dùng và mặt hà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 các 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 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
- Mục do người dùng tạo nhưng hiện thuộc sở hữu của người khác
- Các mục trong thùng rác
- Phím tắt
- Phím tắt của bên thứ ba
Những đố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
- Mục được chia sẻ với người dùng nhưng thuộc sở hữu của người khác
- Mục thuộc sở hữu của người dùng 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 đó, họ 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 cho người dùng.
Giới hạn về 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 phần Drive của tôi. Những 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.
- 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à nó 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 một 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 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ề 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 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 có nghĩa là bạn không thể lưu trữ một 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 các thư mục con. Tệp con có loại MIME khác với application/vnd.google-apps.folder
sẽ được miễn hạn chế này.
Ví dụ: trong sơ đồ sau, một thư mục mới có thể được lồng bên trong thư mục số 99 nhưng không được 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
.