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 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 }

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ả `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 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` Mục này không đượ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 đố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ả `id` và `value` đều bị bỏ qua.
`kind`	`string` Chỉ có đầu ra. Thao tác 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ỉ đầ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` Mục này không được dùng nữa! 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.

REST Resource: permissions

Tài nguyên: Quyền

Phương thức

`delete`

`get`

`getIdForEmail`

`insert`

`list`

`patch`

`update`