Hướng dẫn này chứa các nhiệm 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.
Nếu muốn chỉ định các trường cần trả về trong phản hồi, bạn có thể đặt fields
tham số hệ thống bằng bất kỳ phương thức nào của tài nguyên drives
. Nếu bạn không chỉ định tham số fields
, thì máy chủ sẽ trả về một tập hợp các trường mặc định dành riêng cho phương thức. Ví dụ: phương thức list
chỉ trả về các trường kind
, id
và name
cho mỗi bộ nhớ dùng chung. Để biết thêm thông tin, hãy xem phần Trả về các trường cụ thể.
Để tìm hiểu thêm về hạn mức thư mục trong bộ nhớ dùng chung, hãy xem bài viết Hạn mức thư mục trong bộ nhớ dùng chung.
Tạo bộ nhớ dùng chung
Để tạo bộ nhớ dùng chung, hãy sử dụng phương thức create
trên tài nguyên drives
bằng tham số requestId
.
Tham số requestId
xác định nỗ lực logic để tạo bộ nhớ dùng chung theo cách thức bất biến. 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 đó mà không tạo ra các yêu cầu trùng lặp. requestId
và nội dung yêu cầu phải giữ nguyên.
Đoạn mã sau đây cho biết cách tạo một ổ đĩa dùng chung:
Java
Python
Node.js
PHP
.NET
Các lệnh gọi đến phương thức create
là phương thức bất biến.
Nếu ổ đĩa 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ương thức này sẽ trả về một thực thể của tài nguyên drives
. Đô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
.
Tạo bộ nhớ dùng chung
Để lấy siêu dữ liệu cho một ổ đĩa dùng chung, hãy sử dụng phương thức get
trên tài nguyên drives
bằng tham số đường dẫn driveId
. Nếu không biết mã nhận dạng ổ đĩa, bạn có thể liệt kê tất cả bộ nhớ dùng chung bằng phương thức list
.
Phương thức get
trả về một bộ nhớ dùng chung dưới dạng một thực thể của tài nguyên drives
.
Để đưa ra yêu cầu với tư cách là quản trị viên miền, hãy đặt tham số truy vấn useDomainAdminAccess
thành true
. Để biết thêm thông tin, hãy xem bài viết Quản lý bộ nhớ dùng chung với tư cách là quản trị viên miền.
Liệt kê bộ nhớ dùng chung
Để liệt kê các bộ nhớ dùng chung của người dùng, hãy sử dụng phương thức list
trên tài nguyên drives
. Phương thức này trả về danh sách bộ nhớ dùng chung.
Truyền các tham số truy vấn sau để tuỳ chỉnh việc phân trang hoặc lọc bộ nhớ dùng chung:
pageSize
: Số lượng tối đa ổ đĩa dùng chung cần trả về trên mỗi trang.pageToken
: Mã thông báo trang nhận được từ một lệnh gọi danh sách trước đó. Cung cấp mã thông báo này để truy xuất trang tiếp theo.q
: Chuỗi truy vấn để tìm kiếm ổ đĩa dùng chung. Để biết thêm thông tin, hãy xem phần Tìm kiếm bộ nhớ dùng chung.useDomainAdminAccess
: Đặt thànhtrue
để đưa ra yêu cầu với tư cách là quản trị viên miền nhằm trả về tất cả bộ nhớ dùng chung của miền mà người yêu cầu là quản trị viên. Để biết thêm thông tin, hãy xem bài viết Quản lý ổ đĩa dùng chung trong vai trò quản trị viên miền.
Cập nhật bộ nhớ dùng chung
Để cập nhật siêu dữ liệu cho một bộ nhớ dùng chung, hãy sử dụng phương thức update
trên tài nguyên drives
bằng tham số đường dẫn driveId
.
Phương thức này trả về một bộ nhớ dùng chung dưới dạng một thực thể của tài nguyên drives
.
Để đưa ra yêu cầu với tư cách là quản trị viên miền, hãy đặt tham số truy vấn useDomainAdminAccess
thành true
. Để biết thêm thông tin, hãy xem bài viết Quản lý bộ nhớ dùng chung với tư cách là quản trị viên miền.
Ẩn và hiện bộ nhớ dùng chung
Để ẩn một bộ nhớ dùng chung khỏi chế độ xem mặc định, hãy sử dụng phương thức hide
trên tài nguyên drives
bằng tham số driveId
.
Khi một bộ nhớ dùng chung bị ẩn, Drive sẽ đánh dấu tài nguyên bộ nhớ dùng chung đó là hidden=true
. Bộ nhớ dùng chung bị ẩn sẽ không xuất hiện trong giao diện người dùng Drive hoặc trong danh sách tệp được trả về.
Để khôi phục bộ nhớ dùng chung về chế độ xem mặc định, hãy sử dụng phương thức unhide
trên tài nguyên drives
bằng tham số driveId
.
Cả hai phương thức đều trả về một bộ nhớ dùng chung dưới dạng một thực thể của tài nguyên drives
.
Xoá bộ nhớ dùng chung
Để xoá vĩnh viễn một bộ nhớ dùng chung, hãy sử dụng phương thức delete
trên tài nguyên drives
bằng tham số driveId
.
Trước khi xoá một bộ nhớ dùng chung, bạn phải di 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. Người dùng cũng phải có quyền role=organizer
đối với thư mục trên ổ đĩa dùng chung. Để 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.
Truyền các tham số truy vấn sau để lọc bộ nhớ dùng chung:
useDomainAdminAccess
: Đặt thànhtrue
để đưa ra yêu cầu với tư cách là quản trị viên miền nhằm trả về tất cả bộ nhớ dùng chung của miền mà người yêu cầu là quản trị viên. Để biết thêm thông tin, hãy xem bài viết Quản lý ổ đĩa dùng chung trong vai trò quản trị viên miền.allowItemDeletion
: Đặt thànhtrue
để xoá các mục trong bộ nhớ dùng chung. Chỉ được hỗ trợ khi bạn cũng đặtuseDomainAdminAccess
thànhtrue
.
Thêm hoặc xoá thành viên bộ nhớ dùng chung
Thêm hoặc xoá thành viên khỏi 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.
Quản lý bộ nhớ dùng chung với tư cách là 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.
Khi sử dụng tài khoản dịch vụ, bạn có thể phải mạo danh một quản trị viên đã xác thực bằng cách sử dụng tính năng mạo danh tài khoản dịch vụ. Xin lưu ý rằng tài khoản dịch vụ không thuộc miền Google Workspace của bạn, không giống như tài khoản người dùng. Nếu bạn chia sẻ các tài sản trên Google Workspace (chẳng hạn như tài liệu hoặc sự kiện) với toàn bộ miền Google Workspace của mình, thì các tài sản đó sẽ không được chia sẻ với tài khoản dịch vụ. Để biết thêm thông tin, hãy xem bài viết Tổng quan về tài khoản dịch vụ.
Khôi phục bộ nhớ dùng chung không có người tổ chức
Mẫu mã sau đây cho biết cách 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
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 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 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. Để tiếp tục nhận tệp, người dùng phải xoá vĩnh viễn các mục khỏi bộ nhớ dùng chung. Xin lưu ý rằng các mục trong thùng rác đượ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
.