Method: permissions.insert

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

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ỉ có nội dung cập nhật gần đây nhất được áp dụng.

Yêu cầu HTTP

POST https://www.googleapis.com/drive/v2/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ã nhận dạng 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 sẽ 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 đến 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.
sendNotificationEmails

boolean

Có gửi email thông báo khi chia sẻ cho người dùng hoặc nhóm hay không. Thông số này sẽ bị bỏ qua và hệ thống sẽ gửi email nếu role là owner.
supportsAllDrives

boolean

Ứ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.
useDomainAdminAccess

boolean

Đưa ra yêu cầu với tư cách là quản trị viên miền; nếu được đặt thành true, thì người yêu cầu sẽ được cấp quyền truy cập nếu tham số mã tệp đề cập đến một bộ nhớ dùng chung và 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ề.
enforceExpansiveAccess
(deprecated)

boolean

Không dùng nữa: Tất cả các yêu cầu đều sử dụng các quy tắc truy cập mở rộ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/docs
  • 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.