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,
  "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
}
Trường
id

string

Mã nhận dạng của người dùng mà quyền này đề cập và giống với permissionId trong tài nguyên Giới thiệu và Tệp. Khi đưa ra yêu cầu drive.permissions.insert, bạn phải chỉ định chính xác một trong các trường id hoặc value trừ phi loại quyền là anyone. Trong trường hợp đó, cả idvalue đều bị bỏ qua.

name

string

Chỉ có đầu ra. Tên của quyền này.

type

string

Loại tài khoản. Các giá trị được phép là:

  • user
  • group
  • domain
  • anyone
role

string

Vai trò chính của người dùng 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
  • reader
additionalRoles[]

string

Vai trò bổ sung của người dùng này. Hiện tại, chúng tôi chỉ cho phép sử dụng commenter. Tuy nhiên, chúng tôi có thể sẽ hỗ trợ thêm nhiều ngôn ngữ khác trong tương lai.

authKey
(deprecated)

string

Chỉ có đầu ra. Không dùng nữa.

value

string

Địa chỉ email hoặc tên miền của đối tượng. Thông tin này được dùng trong quá trình chèn và không được điền sẵn trong câu trả lời. Khi đưa ra yêu cầu drive.permissions.insert, bạn phải chỉ định chính xác một trong các trường id hoặc value trừ phi loại quyền là anyone. Trong trường hợp đó, cả idvalue đều bị bỏ qua.

kind

string

Chỉ có đầu ra. Thao tác này luôn là drive#permission.

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. Đây là trường chỉ đầu ra khi loại quyền là user hoặc group.

domain

string

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 khi loại quyền là user, group hoặc domain.

etag

string

Chỉ có đầu ra. Thẻ ETag của quyền.

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[].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
  • reader
permissionDetails[].additionalRoles[]

string

Chỉ có đầu ra. Vai trò bổ sung của người dùng này. Hiện tại, chúng tôi chỉ hỗ trợ commenter, nhưng chúng tôi có thể sẽ hỗ trợ thêm nhiều ngôn ngữ khác trong tương lai.

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[].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.

expirationDate

string

Thời gian quyền này sẽ hết hạn (ngày giờ RFC 3339). Ngày 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
  • Ngày phải là ngày trong tương lai
  • Ngày này không được cách quá một năm trong tương lai
teamDrivePermissionDetails[]
(deprecated)

object

Chỉ có đầu ra. Không dùng nữa: Chuyển sang dùng permissionDetails.

teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

Chỉ có đầu ra. Không dùng nữa: Chuyển sang dùng permissionDetails/permissionType.

teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

Chỉ có đầu ra. Không dùng nữa: Chuyển sang dùng permissionDetails/role.

teamDrivePermissionDetails[]
(deprecated).additionalRoles[]
(deprecated)

string

Chỉ có đầu ra. Không dùng nữa: Chuyển sang dùng permissionDetails/additionalRoles.

teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

Chỉ có đầu ra. Không dùng nữa: Chuyển sang dùng permissionDetails/inheritedFrom.

teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

Chỉ có đầu ra. Không dùng nữa: Chuyển sang 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. published 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

delete

Xoá một quyền khỏi tệp hoặc bộ nhớ dùng chung.

get

Được cấp quyền theo mã nhận dạng.

getIdForEmail

Trả về mã quyền của một địa chỉ email.

insert

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

list

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

patch

Cập nhật một quyền bằng cách sử dụng ngữ nghĩa của bản vá.

update

Cập nhật một quyền.