Hướng dẫn này chứa các tác vụ liên quan đến việc quản lý bộ nhớ dùng chung, chẳng hạn như tạo bộ nhớ dùng chung và quản lý thành viên cũng như quyền, bằng cách sử dụng Google Drive API.
Để biết thêm thông tin về giới hạn thư mục trong bộ nhớ dùng chung, hãy xem phần Giới hạn về thư mục.
Tạo bộ nhớ dùng chung
Để tạo bộ nhớ dùng chung, hãy sử dụng phương thức drives.create
.
Java
Python
Node.js
PHP
.NET
Các lệnh gọi đến phương thức drives.create
là các lệnh gọi bất biến.
Tham số requestId
xác định nỗ lực hợp lý để tạo ổ đĩa dùng chung. Nếu yêu cầu hết thời gian chờ hoặc trả về một lỗi phụ trợ không xác định, thì bạn có thể lặp lại yêu cầu đó. requestId
và nội dung của yêu cầu phải giữ nguyên.
Nếu bộ nhớ dùng chung được tạo thành công trong một yêu cầu trước đó hoặc do một lần thử lại, thì phản hồi thông thường sẽ được trả về. Đôi khi, chẳng hạn như sau một thời gian dài hoặc nếu nội dung yêu cầu đã thay đổi, thì có thể trả về lỗi 409
cho biết bạn phải loại bỏ requestId
.
Thêm hoặc xoá thành viên bộ nhớ dùng chung
Thêm hoặc xoá thành viên bộ nhớ dùng chung bằng tài nguyên permissions
.
Để thêm thành viên, hãy tạo quyền trên bộ nhớ dùng chung. Bạn cũng có thể sử dụng các phương thức cấp quyền cho từng tệp trong bộ nhớ dùng chung để cấp thêm đặc quyền cho các thành viên hoặc cho phép những người không phải là thành viên cộng tác trên các mục cụ thể.
Để biết thêm thông tin và mã mẫu, hãy xem phần Chia sẻ tệp, thư mục và ổ đĩa.
Xoá bộ nhớ dùng chung
Sử dụng phương thức drives.delete
để xoá một bộ nhớ dùng chung. Bạn phải chuyển tất cả nội dung trong bộ nhớ dùng chung vào thùng rác hoặc xoá nội dung đó trước khi xoá bộ nhớ dùng chung.
Quản lý bộ nhớ dùng chung cho quản trị viên miền
Áp dụng tham số useDomainAdminAccess
với các tài nguyên drives
và permissions
để quản lý bộ nhớ dùng chung trong một tổ chức.
Người dùng gọi các phương thức này bằng useDomainAdminAccess=true
phải có Drive and Docs
đặc quyền quản trị viên.
Quản trị viên có thể tìm kiếm bộ nhớ dùng chung hoặc cập nhật quyền đối với bộ nhớ dùng chung thuộc sở hữu của tổ chức, bất kể quản trị viên có phải là thành viên của bộ nhớ dùng chung đó hay không.
Khôi phục bộ nhớ dùng chung không có người tổ chức
Ví dụ sau đây minh hoạ cách sử dụng các tài nguyên này để khôi phục ổ đĩa dùng chung không còn người tổ chức.
Java
Python
Node.js
PHP
.NET
Ngăn người dùng tải xuống, in hoặc sao chép tệp
Bạn có thể giới hạn cách người dùng tải xuống, in và sao chép tệp trong bộ nhớ dùng chung.
Để xác định xem người dùng có thể thay đổi các hạn chế tải xuống do người tổ chức áp dụng của một bộ nhớ dùng chung hay không, hãy kiểm tra trường boolean capabilities.canChangeDownloadRestriction
. Nếu capabilities.canChangeDownloadRestriction
được đặt thành true
, thì bạn có thể áp dụng các hạn chế tải xuống cho bộ nhớ dùng chung. Để biết thêm thông tin, hãy xem bài viết Tìm hiểu các chức năng của tệp.
Tài nguyên drives
chứa một tập hợp các trường boolean restrictions
dùng để cho biết liệu một hành động có thể được thực hiện trên bộ nhớ dùng chung hay không.
Các quy định hạn chế áp dụng cho bộ nhớ dùng chung hoặc các mục trong bộ nhớ dùng chung.
Bạn có thể đặt các quy tắc hạn chế bằng phương thức drives.update
.
Để áp dụng hạn chế tải xuống cho một bộ nhớ dùng chung, người quản lý bộ nhớ dùng chung có thể đặt trường restrictions.downloadRestriction
của tài nguyên drives
bằng cách sử dụng đối tượng DownloadRestriction
.
Đặt trường boolean restrictedForReaders
thành true
để khai báo rằng cả hoạt động tải xuống và sao chép đều bị hạn chế đối với người đọc. Việc đặt restrictedForWriters
trường boolean thành true
cho biết rằng cả hoạt động tải xuống và sao chép đều bị hạn chế đối với người viết. Xin lưu ý rằng nếu trường restrictedForWriters
là true
, thì người đọc cũng sẽ bị hạn chế tải xuống và sao chép. Tương tự, việc đặt restrictedForWriters
thành true
và restrictedForReaders
thành false
tương đương với việc đặt cả restrictedForWriters
và restrictedForReaders
thành true
.
Khả năng tương thích ngược
Khi giới thiệu đối tượng DownloadRestriction
, chức năng của trường boolean restrictions.copyRequiresWriterPermission
đã được cập nhật.
Giờ đây, việc đặt restrictions.copyRequiresWriterPermission
thành true
sẽ cập nhật trường boolean restrictedForReaders
của đối tượng DownloadRestriction
thành true
để khai báo rằng cả hoạt động tải xuống và sao chép đều bị hạn chế đối với người đọc.
Việc đặt trường copyRequiresWriterPermission
thành false
sẽ cập nhật cả trường restrictedForWriters
và restrictedForReaders
thành false
. Điều này có nghĩa là chế độ cài đặt hạn chế tải xuống hoặc sao chép sẽ bị xoá đối với tất cả người dùng.
Các trường kiểm soát tính năng tải xuống, in và sao chép
Bảng sau đây liệt kê các trường tài nguyên drives
ảnh hưởng đến chức năng tải xuống, in và sao chép:
Trường | Mô tả | Phiên bản |
---|---|---|
capabilities.canCopy |
Người dùng hiện tại có thể sao chép tệp trong bộ nhớ dùng chung hay không. | v2 và v3 |
capabilities.canDownload |
Liệu người dùng hiện tại có thể tải tệp xuống trong bộ nhớ dùng chung hay không. | v2 và v3 |
capabilities.canChangeCopyRequiresWriterPermission |
Liệu người dùng hiện tại có thể thay đổi chế độ hạn chế copyRequiresWriterPermission của bộ nhớ dùng chung hay không. |
v2 và v3 |
capabilities.canResetDriveRestrictions |
Liệu người dùng hiện tại có thể đặt lại các hạn chế của bộ nhớ dùng chung về chế độ mặc định hay không. | v2 và v3 |
capabilities.canChangeDownloadRestriction |
Liệu người dùng hiện tại có thể thay đổi chế độ hạn chế tải xuống của một bộ nhớ dùng chung hay không. | Chỉ v3 |
restrictions.copyRequiresWriterPermission |
Liệu người đọc và người nhận xét có bị vô hiệu hoá các tuỳ chọn sao chép, in hoặc tải tệp xuống trong bộ nhớ dùng chung hay không. Khi true , chế độ này sẽ đặt trường có tên tương tự thành true cho mọi tệp trong bộ nhớ dùng chung này. |
v2 và v3 |
restrictions.downloadRestriction |
Các quy định hạn chế tải xuống do người quản lý bộ nhớ dùng chung áp dụng. | Chỉ v3 |
Giới hạn về thư mục
Thư mục trong bộ nhớ dùng chung có một số hạn mức bộ nhớ. Để biết thông tin, hãy xem bài viết Hạn mức bộ nhớ dùng chung trong Google Drive.
Giới hạn về mục
Mỗi thư mục trong bộ nhớ dùng chung của người dùng có giới hạn là 500.000 mục, bao gồm cả tệp, thư mục và lối tắt.
Khi đạt đến hạn mức, bộ nhớ dùng chung sẽ không thể chấp nhận thêm mục. Để nhận lại tệp, người dùng phải xoá vĩnh viễn các mục khỏi thư mục. Xin lưu ý rằng các mục trong thùng rác sẽ được tính vào hạn mức, nhưng các mục bị xoá vĩnh viễn thì không. Để 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.
Giới hạn về chiều sâu của thư mục
Một thư mục trong bộ nhớ dùng chung không thể chứa quá 100 cấp thư mục được lồng. Đ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.
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 teamDriveHierarchyTooDeep
.