Method: permissions.create

Tạo 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 đồng thời về quyền trên cùng một tệp; chỉ áp dụng nội dung cập nhật gần đây nhất.

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

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

boolean

Ngừng sử dụng: Hãy xem moveToNewOwnersRoot để biết thông tin chi tiết.
moveToNewOwnersRoot

boolean

Thông 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 của mục đó. Nếu bạn đặt giá trị này thành true, mục sẽ được 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ì các thành phần mẹ sẽ không thay đổi.
sendNotificationEmail

boolean

Liệu có gửi email thông báo khi chia sẻ với 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, và không được phép đối với các yêu cầu khác. Bạn không được tắt tính năng 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: Hãy sử dụng supportsAllDrives.
transferOwnership

boolean

Liệu 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. Tham số này là bắt buộc để xác nhận hiệu ứng phụ.
useDomainAdminAccess

boolean

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

boolean

Liệu 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ể Permission mới tạo.

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 đánh giá bảo mật để ứng dụng của bạn có thể sử dụng. Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.