Trang này được dịch bởi Cloud Translation API.

REST Resource: permissions

Tài nguyên: Quyền
- Biểu diễn dưới dạng JSON
Phương thức

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.

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, "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, "inheritedPermissionsDisabled": boolean }

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,
  "inheritedPermissionsDisabled": boolean
}

Trường
`id`	`string` Mã nhận dạng của người dùng mà quyền này đề cập đến và giống với `permissionId` trong tài nguyên Giới thiệu và Tệp. Khi tạo yêu cầu `drive.permissions.insert`, bạn phải chỉ định đúng một trong các trường `id` hoặc `value`, trừ phi loại quyền là `anyone`. Trong trường hợp này, cả `id` và `value` đề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, bạn chỉ được phép sử dụng các giá trị sau: `owner` `organizer` `fileOrganizer` `writer` `reader`
`additionalRoles[]`	`string` Các vai trò khác của người dùng này. Hiện tại, chỉ cho phép `commenter`, mặc dù có thể sẽ hỗ trợ thêm trong tương lai.
`authKey (deprecated)`	`string` Mục này không còn được dùng nữa! Chỉ có đầu ra. Không dùng nữa.
`value`	`string` Địa chỉ email hoặc tên miền của thực thể. Thuộc tính này được dùng trong quá trình chèn và không được điền trong các phản hồi. Khi tạo yêu cầu `drive.permissions.insert`, bạn phải chỉ định đúng một trong các trường `id` hoặc `value`, trừ phi loại quyền là `anyone`. Trong trường hợp này, cả `id` và `value` đều bị bỏ qua.
`kind`	`string` Chỉ có đầu ra. Giá trị này luôn là `drive#permission`.
`withLink`	`boolean` Liệu đường liên kết có bắt buộc đối với quyền này hay không.
`photoLink`	`string` Chỉ có đầu ra. Đường liên kết đến ảnh hồ sơ (nếu có).
`selfLink`	`string` Chỉ có đầu ra. Đường liên kết quay lại quyền này.
`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ỉ có đầu ra xuất hiện 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ỉ có giá trị đầu ra xuất hiện khi loại quyền là `user`, `group` hoặc `domain`.
`etag`	`string` Chỉ có đầu ra. ETag của quyền.
`permissionDetails[]`	`object` Chỉ có đầu ra. Thông tin chi tiết về việc quyền trên mục này có được kế thừa hay trực tiếp trên mục này.
`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[].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` `reader`
`permissionDetails[].additionalRoles[]`	`string` Chỉ có đầu ra. Các vai trò khác của người dùng này. Hiện tại, bạn chỉ có thể sử dụng `commenter`, mặc dù có thể sẽ có nhiều loại khác được hỗ trợ trong tương lai.
`permissionDetails[].inheritedFrom`	`string` Chỉ có đầu ra. Mã 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[].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.
`expirationDate`	`string` Thời điểm quyền này hết hạn (ngày-giờ theo RFC 3339). Ngày 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 Ngày phải là ngày trong tương lai Ngày này không được cách thời điểm hiện tại quá một năm
`teamDrivePermissionDetails[] (deprecated)`	`object` Mục này không còn được dùng nữa! Chỉ có đầu ra. Không dùng nữa: Hãy sử dụng `permissionDetails`.
`teamDrivePermissionDetails[] (deprecated).teamDrivePermissionType (deprecated)`	`string` Chỉ có đầu ra. Không dùng nữa: Hãy sử dụng `permissionDetails/permissionType`.
`teamDrivePermissionDetails[] (deprecated).role (deprecated)`	`string` Chỉ có đầu ra. Không dùng nữa: Hãy sử dụng `permissionDetails/role`.
`teamDrivePermissionDetails[] (deprecated).additionalRoles[] (deprecated)`	`string` Chỉ có đầu ra. Không dùng nữa: Hãy sử dụng `permissionDetails/additionalRoles`.
`teamDrivePermissionDetails[] (deprecated).inheritedFrom (deprecated)`	`string` Chỉ có đầu ra. Không dùng nữa: Hãy sử dụng `permissionDetails/inheritedFrom`.
`teamDrivePermissionDetails[] (deprecated).inherited (deprecated)`	`boolean` Chỉ có đầu ra. Không dùng nữa: 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ị. `published` và `metadata` là những giá trị duy nhất được hỗ trợ. `published` : Vai trò của quyền là published_reader. `metadata` : Mục này chỉ hiển thị cho chế độ xem siêu dữ liệu vì mục này có quyền truy cập bị hạn chế và phạm vi có ít nhất quyền đọc đối với mục mẹ. Lưu ý: `metadata` chế độ xem hiện chỉ được hỗ trợ trên các thư mục.
`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.
`inheritedPermissionsDisabled`	`boolean` Khi giá trị này là true, chỉ 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
`delete`	Xoá quyền khỏi một tệp hoặc bộ nhớ dùng chung.
`get`	Lấy quyền theo mã nhận dạng.
`getIdForEmail`	Trả về mã quyền cho một địa chỉ email.
`insert`	Chèn quyền cho một tệp hoặc bộ nhớ dùng chung.
`list`	Liệt kê các quyền của tệp hoặc bộ nhớ dùng chung.
`patch`	Cập nhật quyền bằng cách sử dụng ngữ nghĩa bản vá.
`update`	Cập nhật quyền.

REST Resource: permissions

Tài nguyên: Quyền

Phương thức

`delete`

`get`

`getIdForEmail`

`insert`

`list`

`patch`

`update`