REST Resource: permissions

Tài nguyên: Quyền

Quyền đối với một tệp. Quyền cấp cho người dùng, nhóm, miền hoặc toàn thế giới quyền truy cập vào một 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 của 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
}
Trường
id

string

Chỉ có đầu ra. Mã của quyền này. Đây là giá trị nhận dạng riêng biệt của người nhận tài trợ và được xuất bản 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. "Xinh" tên giá trị của quyền. Sau đây là danh sách ví dụ cho từng loại quyền:

  • user – Tên đầy đủ của người dùng, như được xác định cho Tài khoản Google của họ, chẳng hạn như "Joe Smith".
  • group – Tên của nhóm trên Google Groups, chẳng hạn như "Quản trị viên công ty".
  • domain – Chuỗi tên miền, chẳng hạn như "thecompany.com".
  • anyone – Không có displayName.
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 cung cấp thêm thông tin đối với loại anyone.
kind

string

Chỉ có đầu ra. Xác định loại tài nguyên này. 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 trong bộ nhớ dùng chung này được kế thừa hay trực tiếp trên mục này. Đây là trường chỉ đầu ra, chỉ xuất hiện cho các mục trong bộ nhớ dùng chung.
permissionDetails[].permissionType

string

Chỉ có đầu ra. Loại quyền dành cho 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 những điều sau đây hiện có thể xảy ra:

  • file
  • member
permissionDetails[].inheritedFrom

string

Chỉ có đầu ra. Mã của mặt hàng mà quyền này được kế thừa từ đó. Đây là trường chỉ cho phép đầ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 những điều sau đây hiện có thể xảy ra:

  • 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 phép đầu ra.
emailAddress

string

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

string

Vai trò được cấp bằng quyền này. Mặc dù các giá trị mới có thể được hỗ trợ trong tương lai, nhưng hiện tại chúng tôi cho phép những giá trị sau:

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

boolean

Liệu quyền này có cho phép tìm thấy tệp thông qua tính năng tìm kiếm hay không. 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.
expirationTime

string

Thời gian quyền này sẽ hết hạn (ngày giờ RFC 3339). Thời gian hết hạn có các hạn chế sau:

  • Bạn chỉ có thể đặt các chế độ cài đặt này cho các quyền của người dùng và nhóm.
  • Thời gian này phải là thời gian trong tương lai.
  • Thời gian này không được vượt quá một năm trong tương lai.
teamDrivePermissionDetails[]
(deprecated)

object

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

string

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

string

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

string

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

boolean

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

boolean

Chỉ có đầu ra. Liệu tài khoản 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 về một chế độ xem. " đã xuất bản" 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 quyền đối với 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

 Được 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 một quyền bằng ngữ nghĩa của bản vá.