REST Resource: permissions

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

string

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 permissionId. Mã nhận dạng phải được coi là giá trị không rõ ràng.
displayName

string

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:

  • user – Tên đầy đủ của người dùng, như được định nghĩa cho Tài khoản Google của họ, chẳng hạn như "Joe Smith".
  • group – Tên của Nhóm Google, chẳng hạn như "Quản trị viên của công ty".
  • domain – Tên miền chuỗi, chẳng hạn như "thecompany.com".
  • anyone – Không có displayName nào.
type

string

Loại người nhận tài trợ. Các giá trị hợp lệ là:

  • user
  • group
  • domain
  • anyone

Khi tạo một quyền, nếu type là user hoặc group, thì bạn phải cung cấp emailAddress cho người dùng hoặc nhóm đó. Khi type là domain, bạn phải cung cấp domain. Bạn không cần phải cung cấp thêm thông tin cho loại anyone.
kind

string

Chỉ có đầu ra. Xác định đây là loại tài nguyên. Giá trị: chuỗi cố định "drive#permission".
permissionDetails[]

object

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

string

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:

  • file
  • member
permissionDetails[].inheritedFrom

string

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

string

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:

  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
permissionDetails[].inherited

boolean

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.
emailAddress

string

Địa chỉ email của người dùng hoặc nhóm mà quyền này đề cập đến.
role

string

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:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
allowFileDiscovery

boolean

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 hoặc anyone.
domain

string

Miền mà quyền này tham chiếu đến.
expirationTime

string

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:

  • Bạn chỉ có thể đặt các chế độ cài đặt này theo 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 quá một năm trong tương lai.
teamDrivePermissionDetails[]
(deprecated)

object

Chỉ có đầu ra. Không dùng nữa: Chỉ có đầu ra. Thay vào đó, hãy sử dụng permissionDetails.
teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Không dùng nữa: Chỉ có đầu ra. Thay vào đó, hãy sử dụng permissionDetails/permissionType.
teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Không dùng nữa: Chỉ có đầu ra. Thay vào đó, hãy sử dụng permissionDetails/inheritedFrom.
teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Không dùng nữa: Chỉ có đầu ra. Thay vào đó, hãy sử dụng permissionDetails/role.
teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Không dùng nữa: Chỉ có đầu ra. Thay vào đó, hãy sử dụng permissionDetails/inherited.
deleted

boolean

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

string

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

boolean

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 user cho các tệp không nằm trong bộ nhớ dùng chung.

Phương thức

create

 Tạo quyền đối với một tệp hoặc bộ nhớ dùng chung.

delete

 Xoá một quyền.

get

 Xin cấp quyền theo mã nhận dạng.

list

 Liệt kê các quyền của một tệp hoặc bộ nhớ dùng chung.

update

 Cập nhật quyền với bản vá ngữ nghĩa.