Method: permissions.create

Tạo quyền cho một tệp hoặc bộ nhớ dùng chung. Để biết thêm thông tin, hãy xem bài viết Chia sẻ tệp, thư mục và ổ đĩa.

Cảnh báo: Chúng tôi không hỗ trợ các thao tác cấp quyền đồng thời trên cùng một tệp; chỉ nội dung cập nhật gần đây nhất mới được áp dụng.

Yêu cầu HTTP

POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
fileId

string

Mã của tệp hoặc bộ nhớ dùng chung.

Tham số truy vấn

Thông số
emailMessage

string

Một thông báo tuỳ chỉnh bằng văn bản thuần tuý để đưa vào email thông báo.
enforceSingleParent
(deprecated)

boolean

Không dùng nữa: Hãy xem moveToNewOwnersRoot để biết thông tin chi tiết.
moveToNewOwnersRoot

boolean

Tham số này chỉ có hiệu lực nếu mục không nằm trong bộ nhớ dùng chung và yêu cầu đang cố gắng chuyển quyền sở hữu mục. Nếu bạn đặt thành true, mục đó sẽ được di chuyển vào thư mục gốc Drive của tôi của chủ sở hữu mới và tất cả thư mục mẹ trước đó sẽ bị xoá. Nếu bạn đặt thành false, thì cha mẹ sẽ không thay đổi.
sendNotificationEmail

boolean

Có gửi email thông báo khi chia sẻ cho người dùng hoặc nhóm hay không. Giá trị mặc định là true đối với người dùng và nhóm, đồng thời không được phép đối với các yêu cầu khác. Bạn không được tắt chế độ này khi chuyển quyền sở hữu.
supportsAllDrives

boolean

Liệu ứng dụng yêu cầu có hỗ trợ cả Drive của tôi và bộ nhớ dùng chung hay không.
supportsTeamDrives
(deprecated)

boolean

Không dùng nữa: Thay vào đó, hãy sử dụng supportsAllDrives.
transferOwnership

boolean

Có chuyển quyền sở hữu cho người dùng được chỉ định và hạ cấp chủ sở hữu hiện tại xuống vai trò người viết hay không. Bạn phải cung cấp tham số này để xác nhận tác dụng phụ. Để biết thêm thông tin, hãy xem phần Chuyển quyền sở hữu tệp.
useDomainAdminAccess

boolean

Gửi yêu cầu với tư cách là quản trị viên miền.

Nếu được đặt thành true và nếu đáp ứng các điều kiện bổ sung sau, thì người yêu cầu sẽ được cấp quyền truy cập:

  1. Tham số mã tệp đề cập đến một bộ nhớ dùng chung.
  2. Người yêu cầu là quản trị viên của miền mà bộ nhớ dùng chung thuộc về.

Để biết thêm thông tin, hãy xem bài viết Quản lý bộ nhớ dùng chung với tư cách quản trị viên miền.
enforceExpansiveAccess

boolean

Yêu cầu có nên thực thi các quy tắc truy cập mở rộng hay không.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Permission.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể mới tạo của Permission.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

Một số phạm vi bị hạn chế và yêu cầu bạn phải đánh giá bảo mật để ứng dụng của bạn có thể sử dụng các phạm vi đó. Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.