Tài nguyên: Quyền
Quyền đối với tệp. Quyền cấp cho người dùng, nhóm, miền hoặc mọi người quyền truy cập vào tệp hoặc hệ phân cấp thư mục.
Một số phương thức tài nguyên (chẳng hạn như permissions.update
) yêu cầu permissionId
. Sử dụng phương thức permissions.list
để truy xuất mã nhận dạng cho tệp, thư mục hoặc bộ nhớ dùng chung.
Biểu diễn dưới dạng JSON |
---|
{ "id": string, "displayName": string, "type": string, "kind": string, "permissionDetails": [ { "permissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "photoLink": string, "emailAddress": string, "role": string, "allowFileDiscovery": boolean, "domain": string, "expirationTime": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
Các trường | |
---|---|
id |
Chỉ có đầu ra. Mã của quyền này. Đây là giá trị nhận dạng duy nhất của người nhận tài trợ và được phát hành trong Tài nguyên người dùng dưới dạng |
displayName |
Chỉ có đầu ra. Tên "đẹp mắt" của giá trị quyền. Sau đây là danh sách ví dụ về từng loại quyền:
|
type |
Loại người nhận tài trợ. Các giá trị hợp lệ là:
Khi tạo một quyền, nếu |
kind |
Chỉ có đầu ra. Xác định đây là loại tài nguyên. Giá trị: chuỗi cố định |
permissionDetails[] |
Chỉ có đầu ra. Thông tin chi tiết về việc các quyền đối với mục này trong bộ nhớ dùng chung được kế thừa hay trực tiếp trên mục này. Đây là trường chỉ có thể xuất dữ liệu, chỉ xuất hiện đối với các mục trong bộ nhớ dùng chung. |
permissionDetails[].permissionType |
Chỉ có đầu ra. Loại quyền cho người dùng này. Mặc dù các giá trị mới có thể được thêm trong tương lai, nhưng hiện tại, những giá trị sau đây có thể được thêm:
|
permissionDetails[].inheritedFrom |
Chỉ có đầu ra. Mã của mục kế thừa quyền này. Đây là trường chỉ cho kết quả đầu ra. |
permissionDetails[].role |
Chỉ có đầu ra. Vai trò chính của người dùng này. Mặc dù các giá trị mới có thể được thêm vào trong tương lai, nhưng hiện tại, những giá trị sau đây có thể được thêm:
|
permissionDetails[].inherited |
Chỉ có đầu ra. Liệu quyền này có được kế thừa hay không. Trường này luôn được điền sẵn. Đây là trường chỉ cho kết quả đầu ra. |
photoLink |
Chỉ có đầu ra. Đường liên kết đến ảnh hồ sơ của người dùng, nếu có. |
emailAddress |
Địa chỉ email của người dùng hoặc nhóm mà quyền này đề cập đến. |
role |
Vai trò được cấp quyền này. Mặc dù trong tương lai có thể chúng tôi sẽ hỗ trợ các giá trị mới, nhưng hiện tại chúng tôi chấp nhận những giá trị sau:
|
allowFileDiscovery |
Liệu quyền có cho phép mọi người tìm thấy tệp bằng cách tìm kiếm hay không. Cách này chỉ áp dụng cho các quyền thuộc loại |
domain |
Miền mà quyền này tham chiếu đến. |
expirationTime |
Thời gian hết hạn của quyền này (ngày giờ RFC 3339). Thời gian hết hạn có các quy định hạn chế sau:
|
teamDrivePermissionDetails[] |
Chỉ có đầu ra. Không dùng nữa: Chỉ có đầu ra. Thay vào đó, hãy sử dụng |
teamDrivePermissionDetails[] |
Không dùng nữa: Chỉ có đầu ra. Thay vào đó, hãy sử dụng |
teamDrivePermissionDetails[] |
Không dùng nữa: Chỉ có đầu ra. Thay vào đó, hãy sử dụng |
teamDrivePermissionDetails[] |
Không dùng nữa: Chỉ có đầu ra. Thay vào đó, hãy sử dụng |
teamDrivePermissionDetails[] |
Không dùng nữa: Chỉ có đầu ra. Thay vào đó, hãy sử dụng |
deleted |
Chỉ có đầu ra. Liệu tài khoản được liên kết với quyền này đã bị xoá hay chưa. Trường này chỉ liên quan đến quyền của người dùng và nhóm. |
view |
Cho biết chế độ xem của quyền này. Chỉ được điền sẵn cho các quyền thuộc một chế độ xem. "release" là giá trị duy nhất được hỗ trợ. |
pendingOwner |
Liệu tài khoản được liên kết với quyền này có phải là chủ sở hữu đang chờ được phê duyệt hay không. Chỉ được điền sẵn các quyền của loại |
Phương thức |
|
---|---|
|
Tạo quyền đối với một tệp hoặc bộ nhớ dùng chung. |
|
Xoá một quyền. |
|
Xin cấp quyền theo mã nhận dạng. |
|
Liệt kê các quyền của một tệp hoặc bộ nhớ dùng chung. |
|
Cập nhật quyền với bản vá ngữ nghĩa. |