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 bộ thế giới quyền truy cập vào một tệp hoặc hệ thống phân cấp thư mục. Để biết thêm thông tin, hãy xem bài viết Chia sẻ tệp, thư mục và bộ nhớ dùng chung.

Theo mặc định, các yêu cầu cấp quyền chỉ trả về một tập hợp con của các trường. Quyền kind, ID, type và role luôn được trả về. Để truy xuất các trường cụ thể, hãy xem bài viết Trả về các trường cụ thể.

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 một 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,
  "inheritedPermissionsDisabled": boolean
}
Trường
id

string

Chỉ có đầu ra. Mã nhận dạng của quyền này. Đây là giá trị nhận dạng riêng biệt cho người được cấp quyền và được xuất bản trong tài nguyên Người dùng dưới dạng permissionId. Bạn nên coi mã nhận dạng là các giá trị không rõ ràng.
displayName

string

Chỉ có đầu ra. Tên "đẹp" của giá trị quyền. Sau đây là danh sách các 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ư "Dana A."
  • group – Tên của Nhóm Google, chẳng hạn như "Quản trị viên công ty".
  • domain – Tên miền dạng chuỗi, chẳng hạn như "cymbalgroup.com."
  • anyone – Không có displayName.
type

string

Loại người được cấp quyền. Các giá trị được hỗ trợ bao gồm:

  • user
  • group
  • domain
  • anyone

Khi tạo quyền, nếu type là user hoặc group, bạn phải cung cấp emailAddress cho người dùng hoặc nhóm. Nếu type là domain, bạn phải cung cấp domain. Nếu type là anyone, thì không cần cung cấp thêm thông tin.
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 này được kế thừa hay trực tiếp đối với mục này.
permissionDetails[].permissionType

string

Chỉ có đầu ra. Loại quyền cho người dùng này. Các giá trị được hỗ trợ bao gồm:

  • file
  • member
permissionDetails[].inheritedFrom

string

Chỉ có đầu ra. Mã nhận dạng của mục mà quyền này được kế thừa. Trường này chỉ được điền sẵn cho các mục trong bộ nhớ dùng chung.
permissionDetails[].role

string

Chỉ có đầu ra. Vai trò chính của người dùng này. Các giá trị được hỗ trợ bao gồm:

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

Để biết thêm thông tin, hãy xem bài viết Vai trò và quyền.
permissionDetails[].inherited

boolean

Chỉ có đầu ra. 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ỉ có đầu ra.
emailAddress

string

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

string

Vai trò do quyền này cấp. Các giá trị được hỗ trợ bao gồm:

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

Để biết thêm thông tin, hãy xem bài viết Vai trò và quyền.
allowFileDiscovery

boolean

Quyền này có cho phép phát hiện tệp thông qua tìm kiếm hay không. Trường này chỉ áp dụng cho các quyền thuộc loại domain hoặc anyone.
domain

string

Chỉ có đầu ra. Miền mà quyền này đề cập đến.
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 quy tắc hạn chế sau:

  • Bạn chỉ có thể đặt thời gian hết hạn 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 quá một năm nữa.
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. Tài khoản được liên kết với quyền này có bị xoá hay không. Trường này chỉ liên quan đến các quyền thuộc loại user hoặc group.
view

string

Cho biết chế độ xem cho quyền này. Chỉ được điền sẵn cho các quyền thuộc một chế độ xem.

Các giá trị duy nhất được hỗ trợ là published và metadata:

  • published: Vai trò của quyền là publishedReader.
  • metadata: Mục chỉ hiển thị ở chế độ xem metadata vì mục có quyền truy cập bị giới hạn và phạm vi có ít nhất quyền đọc đối với thư mục mẹ. Chế độ xem metadata chỉ được hỗ trợ trên các thư mục.

Để biết thêm thông tin, hãy xem bài viết Chế độ xem.
pendingOwner

boolean

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 cho các quyền thuộc loại user đối với các tệp không nằm trong bộ nhớ dùng chung.
inheritedPermissionsDisabled

boolean

Khi true, chỉ những người tổ chức, chủ sở hữu và người dùng có quyền được thêm trực tiếp vào mục mới có thể truy cập vào mục đó.

Phương thức

create

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

delete

 Xoá một quyền.

get

 Lấy một 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 bản vá.