Method: permissions.insert
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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 đồ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/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 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.
|
sendNotificationEmails |
boolean
Có gửi email thông báo khi chia sẻ với 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
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.
|
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/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 đá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.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[],[],null,["# Method: permissions.insert\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nInserts a permission for a file or shared drive.\n\n**Warning:** Concurrent permissions operations on the same file are not supported; only the last update is applied.\n\n### HTTP request\n\n`POST https://www.googleapis.com/drive/v2/files/{fileId}/permissions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------|\n| `fileId` | `string` The ID for the file or shared drive. |\n\n### Query parameters\n\n| Parameters ||\n|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `emailMessage` | `string` A plain text custom message to include in notification emails. |\n| `enforceSingleParent` **(deprecated)** | `boolean` Deprecated: See `moveToNewOwnersRoot` for details. |\n| `moveToNewOwnersRoot` | `boolean` This parameter will only take effect if the item is not in a shared drive and the request is attempting to transfer the ownership of the item. If set to `true`, the item will be moved to the new owner's My Drive root folder and all prior parents removed. If set to `false`, parents are not changed. |\n| `sendNotificationEmails` | `boolean` Whether to send notification emails when sharing to users or groups. This parameter is ignored and an email is sent if the `role` is `owner`. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `useDomainAdminAccess` | `boolean` Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs. |\n| `enforceExpansiveAccess` | `boolean` Whether the request should enforce expansive access rules. |\n\n### Request body\n\nThe request body contains an instance of [Permission](/workspace/drive/api/reference/rest/v2/permissions#Permission).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Permission](/workspace/drive/api/reference/rest/v2/permissions#Permission).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/docs`\n- `\n https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
