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 mọi người quyền truy cập vào một tệp hoặc hệ thống phân cấp thư mục.

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ác trường. Loại quyền, mã nhận dạng, loại và vai trò luôn được trả về. Để truy xuất các trường cụ thể, hãy xem https://developers.google.com/drive/api/guides/fields-parameter.

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
}
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 duy nhất của bên được cấp phép 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ị mờ.
displayName

string

Chỉ có đầu ra. Tên "đẹp" của giá trị quyền. Sau đây là danh sách ví dụ cho từng loại quyền:

  • user – Họ tên đầy đủ của người dùng, đượ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 Google, chẳng hạn như "Quản trị viên của công ty".
  • domain – Tên miền dạng chuỗi, chẳng hạn như "thecompany.com".
  • anyone – Không có displayName.
type

string

Loại bên được cấp phép. Các giá trị hợp lệ là:

  • 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. 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 cho 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 trên mục trên bộ nhớ dùng chung này có được kế thừa hay trực tiếp trên mục này. Đây là trường chỉ có giá trị đầu ra và 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 vào trong tương lai, nhưng hiện tại, bạn có thể sử dụng các giá trị sau:

  • file
  • member
permissionDetails[].inheritedFrom

string

Chỉ có đầu ra. Mã của mục mà quyền này được kế thừa. Đây là trường chỉ có đầ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, bạn có thể sử dụng các giá trị sau:

  • 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ỉ có đầ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 theo 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, bạn chỉ được phép sử dụng các giá trị sau:

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

boolean

Quyền này có cho phép phát hiện tệp thông qua tính năng tìm kiếm hay không. Điều 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 điểm quyền này hết hạn (ngày-giờ theo 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 quyền này 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 vượt 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. 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 cho quyền này. Chỉ được điền sẵn cho các quyền thuộc về một thành phần hiển thị. "đã 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ờ xử lý hay không. Chỉ được điền cho các quyền loại user đối với các tệp không nằm trong bộ nhớ dùng chung.

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 quyền theo mã nhận dạng.

list

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

update

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