Method: permissions.create
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Dosya veya ortak drive için izin oluşturur.
Uyarı: Aynı dosyada eşzamanlı izin işlemleri desteklenmez. Yalnızca son güncelleme uygulanır.
HTTP isteği
POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler |
fileId |
string
Dosyanın veya ortak Drive'ın kimliği.
|
Sorgu parametreleri
| Parametreler |
emailMessage |
string
Bildirim e-postasına eklenecek düz metin biçiminde özel bir mesaj.
|
enforceSingleParent
(deprecated) |
boolean
Kullanımdan kaldırıldı: Ayrıntılar için moveToNewOwnersRoot sayfasına bakın.
|
moveToNewOwnersRoot |
boolean
Bu parametre yalnızca öğe bir ortak Drive'da değilse ve istek, öğenin sahipliğini aktarmaya çalışıyorsa geçerli olur. true olarak ayarlanırsa öğe, yeni sahibin Drive'ım kök klasörüne taşınır ve önceki tüm üst klasörler kaldırılır. false olarak ayarlanırsa üst öğeler değiştirilmez.
|
sendNotificationEmail |
boolean
Kullanıcılarla veya gruplarla paylaşım yaparken bildirim e-postası gönderilip gönderilmeyeceği. Bu ayar, kullanıcılar ve gruplar için varsayılan olarak true'dır ve diğer istekler için izin verilmez. Sahiplik aktarımları için devre dışı bırakılmamış olmalıdır.
|
supportsAllDrives |
boolean
İstek gönderen uygulamanın hem Drive'ım hem de ortak Drive'ları destekleyip desteklemediği
|
supportsTeamDrives
(deprecated) |
boolean
Desteği sonlandırıldı: Bunun yerine supportsAllDrives politikasını kullanın.
|
transferOwnership |
boolean
Sahipliğin belirtilen kullanıcıya aktarılıp aktarılmayacağı ve mevcut sahibin yazar erişim düzeyine düşürülüp düşürülmeyeceği. Bu parametre, yan etkinin onaylanması için gereklidir.
|
useDomainAdminAccess |
boolean
İsteği alan yöneticisi olarak gönderin. Doğru olarak ayarlanırsa dosya kimliği parametresi bir ortak Drive'ı ifade ediyorsa ve istekte bulunan kişi, ortak Drive'ın ait olduğu alanın yöneticisiyse istekte bulunan kişiye erişim izni verilir.
|
enforceExpansiveAccess |
boolean
İsteğin, kapsamlı erişim kurallarını zorunlu kılıp kılmayacağı.
|
İstek içeriği
İstek metni, Permission öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılı olursa yanıt gövdesi, Permission öğesinin yeni oluşturulmuş bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
Bazı kapsamlar kısıtlanmıştır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi yapılması gerekir. Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-27 UTC.
[null,null,["Son güncelleme tarihi: 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)."]]
