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 API Google Drive.
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, 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 bài viết Trả về
các trường cụ thể.
Để tìm hiểu thêm về giới hạn thư mục trong bộ nhớ dùng chung, hãy xem bài viết Giới hạn 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 create
phương thức trên tài nguyên drives với
requestId tham số.
Tham số requestId xác định nỗ lực logic để tạo bộ nhớ dùng chung một cách bất biến. Nếu yêu cầu hết thời gian chờ hoặc trả về lỗi không xác định ở phần phụ trợ, thì bạn có thể lặp lại cùng một yêu cầu và sẽ không tạo bản sao. requestId và nội dung của yêu cầu phải giữ nguyên.
Đoạn mã mẫu sau đây cho biết cách tạo bộ nhớ dùng chung:
Java
Python
Node.js
PHP
.NET
Các lệnh gọi đến phương thức create là
bất biế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 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 của yêu cầu đã thay đổi), lỗi 409 có thể được trả về cho biết requestId phải bị loại bỏ.
Lấy bộ nhớ dùng chung
Để lấy siêu dữ liệu cho một bộ nhớ dùng chung, hãy sử dụng phương thức
get trên tài nguyên drives với tham số đường dẫn driveId. Nếu bạn
không biết mã bộ nhớ dùng chung, 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 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ê bộ nhớ dùng chung của người dùng, hãy sử dụng list
phương thức trên drives tài nguyên. 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 bộ nhớ 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 bộ nhớ dùng chung. Để biết thêm thông tin, hãy xem bài viết 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ý bộ nhớ dùng chung với tư cách là 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 với 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 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 với 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 không xuất hiện trong giao diện người dùng Drive hoặc trong danh sách các 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 với tham số driveId.
Cả hai phương thức đều trả về một bộ nhớ dùng chung dưới dạng 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 với tham số driveId.
Trước khi xoá 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á. Người dùng cũng phải có role=organizer trên thư mục bộ nhớ dùng chung. Để biết thêm thông tin, hãy xem bài viết Chuyển tệp và thư mục 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ý bộ nhớ dùng chung với tư cách là 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ợ khiuseDomainAdminAccesscũng được đặt thànhtrue.
Thêm hoặc xoá thành viên của bộ nhớ dùng chung
Thêm hoặc xoá thành viên của bộ nhớ dùng chung bằng cách sử dụ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 trên từng tệp trong bộ nhớ dùng chung để cấp thêm đặc quyền cho thành viên hoặc cho phép 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 bài viết Chia sẻ tệp, thư mục và bộ nhớ dùng chung.
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 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ó đặc quyền quản trị viên
Drive and Docs .
Quản trị viên có thể tìm kiếm bộ nhớ dùng chung hoặc cập nhật quyền cho 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ất kỳ bộ nhớ dùng chung nào hay không.
Khi sử dụng tài khoản dịch vụ, bạn có thể phải mạo danh 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 của 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, 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
Đoạn mã mẫu sau đây cho biết cách khôi phục bộ nhớ 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 có thể 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 quy định hạn chế tải xuống do người tổ chức áp dụng
của 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 quy định hạn chế tải xuống cho bộ nhớ dùng chung. Để biết thêm thông tin, hãy xem
Tìm hiểu về các tính 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 có thể thực hiện một hành động 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 bên trong bộ nhớ dùng chung.
Bạn có thể đặt các quy định hạn chế bằng phương thức drives.update.
Để áp dụng các quy định hạn chế tải xuống cho 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 đối tượng
DownloadRestriction.
Việc đặt trường boolean restrictedForReaders thành true sẽ khai báo rằng cả việc tải xuống và sao chép đều bị hạn chế đối với người đọc. Việc đặt trường boolean restrictedForWriters thành true sẽ khai báo rằng cả việc 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ì việc tải xuống và sao chép cũng bị hạn chế đối với người đọc. 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 đối tượng DownloadRestriction được giới thiệu, 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ả việc 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à các 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 |
Liệu 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 quy định 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 quy định hạn chế của bộ nhớ dùng chung về 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 quy định hạn chế tải xuống của bộ nhớ dùng chung hay không. | chỉ v3 |
restrictions.copyRequiresWriterPermission |
Liệu các tuỳ chọn sao chép, in hoặc tải tệp xuống bên trong bộ nhớ dùng chung có bị tắt đối với người đọc và người nhận xét hay không. Khi true, trường này sẽ đặt trường có tên tương tự thành true cho bất kỳ tệp nào bên 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 thư mục
Thư mục trong bộ nhớ dùng chung có một số giới hạn về bộ nhớ. Để biết thông tin, hãy xem Giới hạn bộ nhớ dùng chung trong Google Drive.
Giới hạn mục
Bộ nhớ dùng chung của mỗi người dùng có giới hạn là 500.000 mục, bao gồm tệp, thư mục và lối tắt.
Khi đạt đến giới hạn, bộ nhớ dùng chung sẽ không thể chấp nhận các mục nữa. Để 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 giới hạn, nhưng các mục đã xoá vĩnh viễn thì không. Để biết thêm thông tin, hãy xem bài viết Chuyển tệp và thư mục vào thùng rác hoặc xoá tệp và thư mục.
Giới hạn độ sâu 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ữ 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 thư mục con.
Các nỗ lực thêm hơn 100 cấp thư mục sẽ trả về phản hồi mã trạng thái
teamDriveHierarchyTooDeep
HTTP.