Method: permissions.insert
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir dosya veya ortak Drive için izin ekler.
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/v2/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-postalarına eklenecek düz metin özel mesajı.
|
enforceSingleParent
(deprecated) |
boolean
Desteği sonlandırıldı: Ayrıntılar için moveToNewOwnersRoot başlıklı makaleyi inceleyin.
|
moveToNewOwnersRoot |
boolean
Bu parametre yalnızca öğe 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 ebeveynler değiştirilmez.
|
sendNotificationEmails |
boolean
Kullanıcılara veya gruplara paylaşım yapılırken bildirim e-postası gönderilip gönderilmeyeceği. Bu parametre yoksayılır ve role owner ise bir e-posta gönderilir.
|
supportsAllDrives |
boolean
İstekte bulunan 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.
|
useDomainAdminAccess |
boolean
İsteği bir alan yöneticisi olarak gönderin. Doğru olarak ayarlanırsa dosya kimliği parametresi bir ortak Drive'ı ifade ediyorsa ve istek sahibi, ortak Drive'ın ait olduğu alanın yöneticisiyse istek sahibine erişim izni verilir.
|
enforceExpansiveAccess |
boolean
İsteğin kapsamlı erişim kurallarını uygulaması gerekip gerekmediği.
|
İstek içeriği
İstek metni, Permission öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılı olursa yanıt metni, yeni oluşturulmuş bir Permission örneği içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
Bazı kapsamlar kısıtlıdır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi yapılması gerekir. Daha fazla bilgi için Yetkilendirme kılavuzuna 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-07-25 UTC.
[null,null,["Son güncelleme tarihi: 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)."]]
