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, "name": string, "type": string, "role": string, "additionalRoles": [ string ], "authKey": string, "value": string, "kind": string, "withLink": boolean, "photoLink": string, "selfLink": string, "emailAddress": string, "domain": string, "etag": string, "permissionDetails": [ { "permissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "expirationDate": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "role": string, "additionalRoles": [ string ], "inheritedFrom": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
Các trường | |
---|---|
id |
Mã nhận dạng của người dùng có quyền này, giống với |
name |
Chỉ có đầu ra. Tên của quyền này. |
type |
Loại tài khoản. Các giá trị được cho phép là:
|
role |
Vai trò chính của người dùng 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:
|
additionalRoles[] |
Các vai trò khác của người dùng này. Chúng tôi hiện chỉ cho phép |
authKey |
Chỉ có đầu ra. Không dùng nữa. |
value |
Địa chỉ email hoặc tên miền của thực thể. Thông tin này được dùng trong các lượt chèn và không được điền sẵn vào các câu trả lời. Khi đưa ra yêu cầu |
kind |
Chỉ có đầu ra. Giá trị này luôn là |
withLink |
Liệu đường liên kết có bắt buộc đối với quyền này hay không. |
photoLink |
Chỉ có đầu ra. Một đường liên kết đến ảnh hồ sơ, nếu có. |
selfLink |
Chỉ có đầu ra. Đường liên kết quay lại quyền này. |
emailAddress |
Chỉ có đầu ra. Địa chỉ email của người dùng hoặc nhóm mà quyền này đề cập đến. Đây là trường chỉ đầu ra xuất hiện khi loại quyền là |
domain |
Chỉ có đầu ra. Tên miền của thực thể mà quyền này đề cập đến. Đây là trường chỉ đầu ra xuất hiện khi loại quyền là |
etag |
Chỉ có đầu ra. Thẻ ETag của quyền. |
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[].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[].additionalRoles[] |
Chỉ có đầu ra. Các vai trò khác của người dùng này. Hiện tại, bạn chỉ có thể dùng |
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[].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. |
expirationDate |
Thời gian hết hạn của quyền này (ngày giờ RFC 3339). Ngày hết hạn có các giới hạn sau:
|
teamDrivePermissionDetails[] |
Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy dùng |
teamDrivePermissionDetails[] |
Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy dùng |
teamDrivePermissionDetails[] |
Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy dùng |
teamDrivePermissionDetails[] |
Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy dùng |
teamDrivePermissionDetails[] |
Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy dùng |
teamDrivePermissionDetails[] |
Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy 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. |
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 |
|
---|---|
|
Xoá quyền khỏi tệp hoặc bộ nhớ dùng chung. |
|
Xin cấp quyền theo mã nhận dạng. |
|
Trả về mã nhận dạng quyền cho một địa chỉ email. |
|
Chèn quyền đối với một tệp hoặc bộ nhớ dùng chung. |
|
Liệt kê các quyền của một tệp hoặc bộ nhớ dùng chung. |
|
Cập nhật một quyền bằng bản vá ngữ nghĩa. |
|
Cập nhật một quyền. |