Mỗi tệp, thư mục và bộ nhớ dùng chung trên Google Drive đều có các tài nguyên permissions
được liên kết. Mỗi tài nguyên xác định quyền cho một type
(user
, group
, domain
, anyone
) và role
(owner
, organizer
, fileOrganizer
, writer
, commenter
, reader
) cụ thể. Ví dụ: một tệp có thể có quyền cấp cho một người dùng cụ thể (type=user
) quyền chỉ có thể đọc (role=reader
), trong khi một quyền khác cấp cho các thành viên của một nhóm cụ thể (type=group
) quyền thêm nhận xét vào tệp (role=commenter
).
Để biết danh sách đầy đủ các vai trò và thao tác mà mỗi vai trò cho phép, hãy tham khảo phần Vai trò và quyền.
Cách hoạt động của quyền
Danh sách quyền cho một thư mục sẽ truyền xuống dưới. Tất cả tệp và thư mục con kế thừa quyền từ thư mục mẹ. Bất cứ khi nào quyền hoặc hệ phân cấp thay đổi, quá trình truyền tải sẽ xảy ra đệ quy thông qua tất cả các thư mục lồng nhau. Ví dụ: nếu một tệp tồn tại trong một thư mục và sau đó thư mục đó được di chuyển trong một thư mục khác, thì các quyền trên thư mục mới sẽ được truyền đến tệp. Nếu thư mục mới cấp cho người dùng tệp một vai trò mới, chẳng hạn như "người ghi", thì thư mục đó sẽ ghi đè vai trò cũ của họ.
Ngược lại, nếu một tệp kế thừa role=writer
từ một thư mục và được di chuyển sang một thư mục khác cung cấp vai trò "đọc", thì tệp đó hiện sẽ kế thừa role=reader
.
Bạn không thể xoá các quyền được kế thừa khỏi một tệp hoặc thư mục trong bộ nhớ dùng chung. Thay vào đó, bạn phải điều chỉnh các quyền này trên mục mẹ trực tiếp hoặc gián tiếp mà các quyền này được kế thừa. Bạn có thể xoá các quyền được kế thừa khỏi các mục trong "Drive của tôi" hoặc "Được chia sẻ với tôi".
Ngược lại, bạn có thể ghi đè các quyền kế thừa trên một tệp hoặc thư mục trong Drive của tôi. Vì vậy, nếu một tệp kế thừa role=writer
từ thư mục My Drive, bạn có thể đặt role=reader
trên tệp đó để giảm cấp độ quyền.
Tìm hiểu về các chức năng của tệp
Tài nguyên permissions
cuối cùng không xác định khả năng của người dùng hiện tại trong việc thực hiện các thao tác trên một tệp hoặc thư mục.
Thay vào đó, tài nguyên files
chứa một tập hợp các trường capabilities
boolean dùng để cho biết liệu có thể thực hiện một thao tác trên tệp hoặc thư mục hay không. API Google Drive đặt các trường này dựa trên tài nguyên quyền của người dùng hiện tại được liên kết với tệp hoặc thư mục.
Ví dụ: khi Alex đăng nhập vào ứng dụng của bạn và cố gắng chia sẻ một tệp, vai trò của Alex sẽ được kiểm tra để xem có quyền đối với tệp đó hay không. Nếu vai trò cho phép họ chia sẻ tệp, thì capabilities
liên quan đến tệp, chẳng hạn như canShare
, sẽ được điền theo vai trò. Nếu Alex muốn chia sẻ tệp, ứng dụng của bạn sẽ kiểm tra capabilities
để đảm bảo canShare
được đặt thành true
.
Để biết ví dụ về cách truy xuất tệp capabilities
, hãy xem phần Nhận chức năng của tệp.
Lấy chức năng của tệp
Khi mở một tệp, ứng dụng của bạn sẽ kiểm tra các chức năng của tệp và hiển thị giao diện người dùng để phản ánh các quyền của người dùng hiện tại. Ví dụ: nếu người dùng không có chức năng canComment
trên tệp, thì chức năng nhận xét sẽ bị tắt trong giao diện người dùng.
Để kiểm tra các chức năng, hãy gọi phương thức get()
trên tài nguyên files
bằng tham số đường dẫn fileId
và tham số fields
được đặt thành trường capabilities
. Để biết thêm thông tin về cách trả về các trường bằng tham số fields
, hãy xem phần Trả về các trường cụ thể.
Hiển thị ví dụ
Mã mẫu sau đây cho biết cách xác minh quyền của người dùng. Phản hồi sẽ trả về danh sách các quyền mà người dùng có đối với tệp. Mỗi chức năng tương ứng với một hành động chi tiết mà người dùng có thể thực hiện. Một số trường chỉ được điền sẵn cho các mục trong bộ nhớ dùng chung.
Yêu cầu
GET https://www.googleapis.com/drive/v3/files/FILE_ID
?fields=capabilities
Đáp
{ "capabilities": { "canAcceptOwnership": false, "canAddChildren": false, "canAddMyDriveParent": false, "canChangeCopyRequiresWriterPermission": true, "canChangeSecurityUpdateEnabled": false, "canComment": true, "canCopy": true, "canDelete": true, "canDownload": true, "canEdit": true, "canListChildren": false, "canModifyContent": true, "canModifyContentRestriction": true, "canModifyLabels": true, "canMoveChildrenWithinDrive": false, "canMoveItemOutOfDrive": true, "canMoveItemWithinDrive": true, "canReadLabels": true, "canReadRevisions": true, "canRemoveChildren": false, "canRemoveMyDriveParent": true, "canRename": true, "canShare": true, "canTrash": true, "canUntrash": true } }
Các trường hợp chia sẻ tài nguyên trên Drive
Có 5 loại tình huống chia sẻ:
Để chia sẻ tệp trong Drive của tôi, người dùng phải có
role=writer
hoặcrole=owner
.Nếu giá trị boolean
writersCanShare
được đặt thànhfalse
cho tệp, thì người dùng phải córole=owner
.Nếu người dùng có
role=writer
có quyền truy cập tạm thời do ngày và giờ hết hạn quản lý, thì họ sẽ không thể chia sẻ tệp. Để biết thêm thông tin, hãy xem bài viết Đặt ngày hết hạn để giới hạn quyền truy cập vào tệp.
Để chia sẻ thư mục trong Drive của tôi, người dùng phải có
role=writer
hoặcrole=owner
.Nếu giá trị boolean
writersCanShare
được đặt thànhfalse
cho tệp, thì người dùng phải córole=owner
có nhiều quyền hơn.Không cho phép quyền truy cập tạm thời (do ngày và giờ hết hạn quy định) trên các thư mục trong Drive của tôi bằng
role=writer
. Để biết thêm thông tin, hãy xem bài viết Đặt ngày hết hạn để giới hạn quyền truy cập vào tệp.
Để chia sẻ tệp trong bộ nhớ dùng chung, người dùng phải có
role=writer
,role=fileOrganizer
hoặcrole=organizer
.- Chế độ cài đặt
writersCanShare
không áp dụng cho các mục trong bộ nhớ dùng chung. Thuộc tính này được coi là luôn được đặt thànhtrue
.
- Chế độ cài đặt
Để chia sẻ thư mục trong bộ nhớ dùng chung, người dùng phải có
role=organizer
.- Nếu bạn đặt giới hạn
sharingFoldersRequiresOrganizerPermission
trên bộ nhớ dùng chung thànhfalse
, thì người dùng córole=fileOrganizer
có thể chia sẻ thư mục trong bộ nhớ dùng chung đó.
- Nếu bạn đặt giới hạn
Để quản lý tư cách thành viên của bộ nhớ dùng chung, người dùng phải có
role=organizer
. Chỉ người dùng và nhóm mới có thể là thành viên của bộ nhớ dùng chung.
Tạo quyền
Bạn cần có hai trường sau đây khi tạo quyền:
type
:type
xác định phạm vi quyền (user
,group
,domain
hoặcanyone
). Quyền cótype=user
áp dụng cho một người dùng cụ thể, trong khi quyền cótype=domain
áp dụng cho mọi người trong một miền cụ thể.role
: Trườngrole
xác định các thao tác màtype
có thể thực hiện. Ví dụ: quyền cótype=user
vàrole=reader
cấp cho một người dùng cụ thể quyền chỉ có thể đọc tệp hoặc thư mục. Hoặc quyền cótype=domain
vàrole=commenter
cho phép mọi người trong miền thêm nhận xét vào tệp. Để xem danh sách đầy đủ các vai trò và thao tác mà mỗi vai trò cho phép, hãy tham khảo phần Vai trò và quyền.
Khi tạo quyền trong type=user
hoặc type=group
, bạn cũng phải cung cấp emailAddress
để liên kết người dùng hoặc nhóm cụ thể với quyền đó.
Khi tạo một quyền trong đó type=domain
, bạn cũng phải cung cấp một domain
để liên kết một miền cụ thể với quyền đó.
Cách tạo quyền:
- Sử dụng phương thức
create()
với tham số đường dẫnfileId
cho tệp hoặc thư mục được liên kết. - Trong phần nội dung yêu cầu, hãy chỉ định
type
vàrole
. - Nếu là
type=user
hoặctype=group
, hãy cung cấpemailAddress
. Nếu làtype=domain
, hãy cung cấpdomain
.
Hiển thị ví dụ
Mã mẫu sau đây cho biết cách tạo quyền. Phản hồi trả về một thực thể của tài nguyên Permission
, bao gồm cả permissionId
được chỉ định.
Yêu cầu
POST https://www.googleapis.com/drive/v3/files/FILE_ID
/permissions
{ "requests": [ { "type": "user", "role": "commenter", "emailAddress": "alex@altostrat.com" } ] }
Đáp
{
"kind": "drive#permission",
"id": "PERMISSION_ID
",
"type": "user",
"role": "commenter"
}
Sử dụng đối tượng mục tiêu
Đối tượng mục tiêu là các nhóm người (chẳng hạn như phòng ban hoặc nhóm) mà bạn có thể đề xuất cho người dùng để chia sẻ các mục của họ. Bạn có thể khuyến khích người dùng chia sẻ các mục với một đối tượng cụ thể hoặc hạn chế hơn thay vì toàn bộ tổ chức. Đối tượng mục tiêu có thể giúp bạn cải thiện tính bảo mật và quyền riêng tư của dữ liệu, đồng thời giúp người dùng dễ dàng chia sẻ một cách phù hợp hơn. Để biết thêm thông tin, hãy xem bài viết Giới thiệu về đối tượng mục tiêu.
Cách sử dụng đối tượng mục tiêu:
Trong Bảng điều khiển dành cho quản trị viên của Google, hãy chuyển đến Trình đơn > Thư mục > Đối tượng mục tiêu.
Chuyển đến mục Đối tượng mục tiêu
Bạn phải đăng nhập bằng một tài khoản có đặc quyền quản trị viên cấp cao để thực hiện nhiệm vụ này.
Trong Danh sách đối tượng mục tiêu, hãy nhấp vào tên của đối tượng mục tiêu. Để tạo đối tượng mục tiêu, hãy xem bài viết Tạo đối tượng mục tiêu
Sao chép mã nhận dạng duy nhất từ URL của đối tượng mục tiêu:
https://admin.google.com/ac/targetaudiences/ID
.Tạo quyền bằng
type=domain
và đặt trườngdomain
thànhID.audience.googledomains.com
.
Để xem cách người dùng tương tác với đối tượng mục tiêu, hãy xem bài viết Trải nghiệm người dùng khi chia sẻ đường liên kết.
Liệt kê tất cả quyền
Sử dụng phương thức list()
trên tài nguyên permissions
để truy xuất tất cả quyền cho một tệp, thư mục hoặc bộ nhớ dùng chung.
Hiển thị ví dụ
Mã mẫu sau đây cho biết cách lấy tất cả quyền. Phản hồi trả về danh sách các quyền.
Yêu cầu
GET https://www.googleapis.com/drive/v3/files/FILE_ID
/permissions
Đáp
{
"kind": "drive#permissionList",
"permissions": [
{
"id": "PERMISSION_ID
",
"type": "user",
"kind": "drive#permission",
"role": "commenter"
}
]
}
Cập nhật quyền
Để cập nhật quyền đối với một tệp hoặc thư mục, bạn có thể thay đổi vai trò được chỉ định. Để biết thêm thông tin về cách tìm nguồn vai trò, hãy xem bài viết Xác định nguồn vai trò.
Gọi phương thức
update()
trên tài nguyênpermissions
với tham số đường dẫnpermissionId
được đặt thành quyền thay đổi và tham số đường dẫnfileId
được đặt thành tệp, thư mục hoặc bộ nhớ dùng chung được liên kết. Để tìmpermissionId
, hãy sử dụng phương thứclist()
trên tài nguyênpermissions
với tham số đường dẫnfileId
.Trong yêu cầu, hãy xác định
role
mới.
Bạn có thể cấp quyền trên từng tệp hoặc thư mục trong bộ nhớ dùng chung ngay cả khi người dùng hoặc nhóm đó đã là thành viên. Ví dụ: Alex có role=commenter
trong gói thành viên của họ đối với một bộ nhớ dùng chung. Tuy nhiên, ứng dụng của bạn có thể cấp cho Alex quyền role=writer
đối với một tệp trong bộ nhớ dùng chung. Trong trường hợp này, vì vai trò mới cho phép nhiều quyền hơn vai trò được cấp thông qua tư cách thành viên, nên quyền mới sẽ trở thành vai trò hiệu quả đối với tệp hoặc thư mục.
Hiển thị ví dụ
Mã mẫu sau đây cho biết cách thay đổi quyền trên một tệp hoặc thư mục từ người bình luận thành người viết. Phản hồi trả về một thực thể của tài nguyên permissions
.
Yêu cầu
PATCH https://www.googleapis.com/drive/v3/files/FILE_ID
/permissions/PERMISSION_ID
{ "requests": [ { "role": "writer" } ] }
Đáp
{
"kind": "drive#permission",
"id": "PERMISSION_ID
",
"type": "user",
"role": "writer"
}
Xác định nguồn vai trò
Để thay đổi vai trò trên một tệp hoặc thư mục, bạn phải biết nguồn của vai trò đó. Đối với bộ nhớ dùng chung, nguồn của vai trò có thể dựa trên tư cách thành viên của bộ nhớ dùng chung, vai trò trên thư mục hoặc vai trò trên tệp.
Để xác định nguồn vai trò cho một bộ nhớ dùng chung hoặc các mục trong bộ nhớ đó, hãy gọi phương thức get()
trên tài nguyên permissions
bằng các tham số đường dẫn fileId
và permissionId
, đồng thời đặt tham số fields
thành trường permissionDetails
.
Để tìm permissionId
, hãy sử dụng phương thức list()
trên tài nguyên permissions
với tham số đường dẫn fileId
. Để tìm nạp trường permissionDetails
trên yêu cầu list
, hãy đặt tham số fields
thành permissions/permissionDetails
.
Trường này liệt kê tất cả các quyền đối với tệp được kế thừa và trực tiếp cho người dùng, nhóm hoặc miền.
Hiển thị ví dụ
Mã mẫu sau đây cho biết cách xác định nguồn vai trò. Phản hồi trả về permissionDetails
của tài nguyên permissions
. Trường inheritedFrom
cung cấp mã nhận dạng của mục mà quyền được kế thừa.
Yêu cầu
GET https://www.googleapis.com/drive/v3/files/FILE_ID
/permissions/PERMISSION_ID
?fields=permissionDetails&supportsAllDrives=true
Đáp
{
"permissionDetails": [
{
"permissionType": "member",
"role": "commenter",
"inheritedFrom": "INHERITED_FROM_ID
",
"inherited": true
},
{
"permissionType": "file",
"role": "writer",
"inherited": false
}
]
}
Cập nhật nhiều quyền bằng yêu cầu hàng loạt
Bạn nên sử dụng yêu cầu hàng loạt để sửa đổi nhiều quyền.
Sau đây là ví dụ về cách thực hiện sửa đổi quyền hàng loạt bằng thư viện ứng dụng.
Java
Python
Node.js
PHP
.NET
Xoá quyền
Để thu hồi quyền truy cập vào một tệp hoặc thư mục, hãy gọi phương thức delete()
trên tài nguyên permissions
với các tham số đường dẫn fileId
và permissionId
được đặt để xoá quyền.
Đối với các mục trong "Drive của tôi", bạn có thể xoá quyền kế thừa. Việc xoá quyền được kế thừa sẽ thu hồi quyền truy cập vào mục và các mục con (nếu có).
Đối với các mục trong bộ nhớ dùng chung, bạn không thể thu hồi các quyền được kế thừa. Thay vào đó, hãy cập nhật hoặc xoá quyền trên tệp hoặc thư mục mẹ.
Phương thức delete()
cũng được dùng để xoá các quyền được áp dụng trực tiếp cho một tệp hoặc thư mục trên ổ đĩa dùng chung.
Hiển thị ví dụ
Mã mẫu sau đây cho biết cách thu hồi quyền truy cập bằng cách xoá permissionId
. Nếu thành công, nội dung phản hồi sẽ trống. Để xác nhận quyền đã bị xoá, hãy sử dụng phương thức list()
trên tài nguyên permissions
với tham số đường dẫn fileId
.
Yêu cầu
DELETE https://www.googleapis.com/drive/v3/files/FILE_ID
/permissions/PERMISSION_ID
Đặt ngày hết hạn để giới hạn quyền truy cập vào tệp
Khi làm việc với mọi người trong một dự án nhạy cảm, bạn nên hạn chế quyền truy cập của họ vào một số tệp nhất định trong Drive sau một khoảng thời gian. Đối với các tệp trong thư mục Drive của tôi, bạn có thể đặt ngày hết hạn để hạn chế hoặc xoá quyền truy cập vào tệp đó.
Cách đặt ngày hết hạn:
Sử dụng phương thức
create()
trên tài nguyênpermissions
và đặt trườngexpirationTime
(cùng với các trường bắt buộc khác). Để biết thêm thông tin, hãy xem phần Tạo quyền.Sử dụng phương thức
update()
trên tài nguyênpermissions
và đặt trườngexpirationTime
(cùng với các trường bắt buộc khác). Để biết thêm thông tin, hãy xem phần Cập nhật quyền.
Trường expirationTime
biểu thị thời điểm quyền hết hạn bằng cách sử dụng ngày giờ theo RFC 3339. Thời gian hết hạn có các hạn chế sau:
- Bạn chỉ có thể đặt các quyền này cho quyền của người dùng và nhóm.
- Thời gian phải là thời gian trong tương lai.
- Thời gian không được vượt quá một năm nữa.
Để biết thêm thông tin về ngày hết hạn, hãy xem các bài viết sau:
Chủ đề có liên quan
- Quản lý các đề xuất cấp quyền truy cập đang chờ xử lý
- Chuyển quyền sở hữu tệp
- Bảo vệ nội dung tệp
- Truy cập vào tệp trong bộ nhớ dùng chung được chia sẻ bằng đường liên kết bằng khoá tài nguyên
- Vai trò và quyền