Method: permissions.create
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Tworzy uprawnienia do pliku lub dysku współdzielonego.
Ostrzeżenie: jednoczesne operacje dotyczące uprawnień do tego samego pliku nie są obsługiwane. Zastosowana zostanie tylko ostatnia aktualizacja.
Żądanie HTTP
POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
fileId |
string
Identyfikator pliku lub dysku współdzielonego.
|
Parametry zapytania
| Parametry |
emailMessage |
string
Niestandardowa wiadomość w formacie zwykłego tekstu, która ma zostać dołączona do e-maila z powiadomieniem.
|
enforceSingleParent
(deprecated) |
boolean
Wycofane: więcej informacji znajdziesz w sekcji moveToNewOwnersRoot.
|
moveToNewOwnersRoot |
boolean
Ten parametr będzie miał wpływ tylko wtedy, gdy element nie znajduje się na dysku współdzielonym, a żądanie dotyczy przeniesienia własności elementu. Jeśli ustawisz true, element zostanie przeniesiony do folderu głównego Mojego dysku nowego właściciela, a wszystkie poprzednie foldery nadrzędne zostaną usunięte. Jeśli ustawisz wartość false, rodzice nie zostaną zmienieni.
|
sendNotificationEmail |
boolean
Określ, czy podczas udostępniania użytkownikom lub grupom ma być wysyłany e-mail z powiadomieniem. W przypadku użytkowników i grup ta wartość domyślna to true. Nie jest ona dozwolona w przypadku innych żądań. Nie może być wyłączona w przypadku przeniesienia własności.
|
supportsAllDrives |
boolean
Czy aplikacja wysyłająca żądanie obsługuje zarówno Mój dysk, jak i dyski współdzielone.
|
supportsTeamDrives
(deprecated) |
boolean
Wycofana: zamiast niej używaj zasady supportsAllDrives.
|
transferOwnership |
boolean
Określa, czy przenieść własność na podanego użytkownika i ograniczyć uprawnienia obecnego właściciela do poziomu osoby z uprawnieniami do edycji. Ten parametr jest wymagany jako potwierdzenie efektu ubocznego.
|
useDomainAdminAccess |
boolean
Wystaw prośbę jako administrator domeny. Jeśli wartość to „true”, wnioskodawca otrzyma dostęp, jeśli parametr fileId odnosi się do dysku współdzielonego, a wnioskodawca jest administratorem domeny, do której należy dysk współdzielony.
|
enforceExpansiveAccess |
boolean
Określa, czy w przypadku żądania mają być egzekwowane reguły dostępu o szerokim zakresie.
|
Treść żądania
Treść żądania zawiera wystąpienie elementu Permission.
Treść odpowiedzi
Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Permission.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
Niektóre zakresy są ograniczone i wymagają oceny bezpieczeństwa, aby aplikacja mogła ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-27 UTC.
[null,null,["Ostatnia aktualizacja: 2025-08-27 UTC."],[],[],null,["# Method: permissions.create\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\nCreates 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/v3/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 of the file or shared drive. |\n\n### Query parameters\n\n| Parameters ||\n|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `emailMessage` | `string` A plain text custom message to include in the notification email. |\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| `sendNotificationEmail` | `boolean` Whether to send a notification email when sharing to users or groups. This defaults to true for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `transferOwnership` | `boolean` Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect. |\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/v3/permissions#Permission).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Permission](/workspace/drive/api/reference/rest/v3/permissions#Permission).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\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)."]]
