Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Rol, kullanıcıların Google Drive kaynaklarında belirli işlemleri gerçekleştirmesine olanak tanıyan bir izin koleksiyonudur. Kullanıcılara, gruplara ve hizmet hesaplarına izin vermek için roller atarsınız. Bir rol atadığınızda, rolün içerdiği tüm izinleri vermiş olursunuz.
Google Drive API'deki her iznin, kullanıcıların bir dosya, klasör veya ortak Drive ile neler yapabileceğini tanımlayan bir rolü vardır. Daha fazla bilgi için Drive kaynaklarını paylaşma senaryoları başlıklı makaleyi inceleyin.
Dosya ve klasör işlemleri
Aşağıdaki tabloda, rol bir görünümle sınırlı olmadığında kullanıcıların her rol için gerçekleştirebileceği işlemler gösterilmektedir. Daha fazla bilgi için Görüntülemeler başlıklı makaleyi inceleyin.
İzin verilen işlem
owner
organizer
fileOrganizer
writer
commenter
reader
Dosya veya klasörün meta verilerini (ör. ad, açıklama) okuma
Dosyanın içeriğini okuma
Klasördeki öğelerin listesini okuma
Dosyaya yorum ekleme
Dosya veya klasörün meta verilerini değiştirme
Dosyanın içeriğini değiştirme
Geçmiş düzeltmelere erişme
Klasöre öğe ekleme
Drive'ım klasöründen öğeleri kaldırma
Drive'ım klasöründeki öğeleri paylaşma
Ayrıntılı dosya izinlerine erişebilir
Öğeleri çöp kutusuna taşıma
Öğeleri çöp kutusundan kurtarma
Çöp kutusunu boşaltma
Dosya veya klasör silme
Drive'ım klasöründeki bir dosyaya içerik kısıtlaması ekleme
Drive'ım klasörlerinde sınırlı erişim ayarını belirleme veya kaldırma
Ortak Drive'lara özgü işlemler
Aşağıdaki tabloda, rolün görüntüleme ile sınırlandırılmadığı durumlarda kullanıcıların her bir rol için gerçekleştirebileceği ortak Drive'a özgü işlemler gösterilmektedir. Daha fazla bilgi için Görünümler başlıklı makaleyi inceleyin.
İzin verilen işlem
owner
organizer
fileOrganizer
writer
commenter
reader
Ortak drive öğesi paylaşma
Ortak drive'lara dosya ekleme
Ortak Drive'ın meta verilerini değiştirme
Ortak drive üyeleri ekleme
Ortak drive'daki öğeleri yeniden düzenleme [1]
Öğeleri ortak Drive'ın dışına taşıma [2]
Ortak Drive'lardaki öğeleri silme [2]
Boş bir ortak drive'ı silme
Ortak Drive'daki bir dosyaya içerik kısıtlaması ekleme
Ortak Drive klasörlerinde sınırlı erişim ayarını belirleme veya kaldırma
Drive API ve Drive kullanıcı arayüzü rolleri arasındaki korelasyon
Drive API ve Drive kullanıcı arayüzü aynı temel izin sistemini kullanır. Ancak rol adları iki ürün arasında biraz farklılık gösterir.
Aşağıdaki tabloda, Drive'ım'daki dosya ve klasörler için rollerin nasıl karşılık geldiği gösterilmektedir.
Drive API rolü
Drive kullanıcı arayüzü rolü
Açıklama
owner
Sahip
Dosya veya klasör üzerinde tam kontrol sağlar.
writer
Düzenleyici
Dosyayı görüntüleme, yorum ekleme ve düzenleme izni verir. Klasörlerde, bu klasördeki dosyaları veya alt klasörleri ekleyebilir, düzenleyebilir ve silebilir.
commenter
Yorumcu
Dosyayı görüntüleme ve yorum ekleme izni verir.
reader
Görüntüleyen
Dosyayı görüntüleme izni verir.
Aşağıdaki tabloda, paylaşılan sürücülerdeki dosya ve klasörler için rollerin nasıl karşılık geldiği gösterilmektedir.
Drive API rolü
Drive kullanıcı arayüzü rolü
Açıklama
organizer
Yönetici
Dosyaları, klasörleri, kullanıcıları ve ayarları yönetme izni verir.
fileOrganizer
İçerik Yöneticisi
İçerik ekleme ve yönetme izni verir. Yeni üyeler için varsayılan rol.
writer
Katkıda Bulunan
Dosyayı görüntüleme, yorum ekleme ve düzenleme izni verir. Ortak Drive'da dosya da oluşturabilir.
commenter
Yorumcu
Dosyayı görüntüleme ve yorum ekleme izni verir.
reader
Görüntüleyen
Dosyayı görüntüleme izni verir.
Görüntüleme sayısı
Bir izin view ile sınırlandırılabilir. Bu durumda rol yalnızca söz konusu görünüm için geçerli olur.
view=published ve role=reader izinleri, reader kullanıcısına dosyanın yayınlanmış görünümüne erişim izni verir ancak dosyaya erişim izni vermez.reader
view=metadata ve role=reader izinleri, reader kullanıcısına klasörün meta verilerine erişim izni verir ancak klasörün içeriğine erişim izni vermez.
Aksine, belirli bir görünümle sınırlı olmayan tüm izinler, dosyanın yayınlanmış görünümüne reader erişim izni verir.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-08-29 UTC."],[],[],null,["# Roles and permissions\n\nA [role](/workspace/drive/api/reference/rest/v3/permissions#Permission.FIELDS.inlinedField_2) is a\ncollection of [permissions](/workspace/drive/api/reference/rest/v3/permissions) that allows users to\nperform specific actions on Google Drive resources. To make permissions\navailable to users, groups, and service accounts, you assign roles. When you\nassign a role, you grant all the permissions that the role contains.\n\nEach permission in the Google Drive API has a role that defines what users can do\nwith a file, folder, or shared drive. For more information, see [Scenarios for\nsharing Drive\nresources](/workspace/drive/api/guides/manage-sharing#sharing-drive-resources).\n\nOperations for files and folders\n--------------------------------\n\nThe following table shows the operations users can perform for each role, when\nthe role isn't restricted to a view. For more information, see [Views](#views).\n\n| Permitted operation | `owner` | `organizer` | `fileOrganizer` | `writer` | `commenter` | `reader` |\n|---------------------------------------------------------------------|---------|-------------|-----------------|----------|-------------|----------|\n| Read the metadata (such as name, description) of the file or folder | | | | | | |\n| Read the content of the file | | | | | | |\n| Read the list of items in the folder | | | | | | |\n| Add comments to the file | | | | | | |\n| Modify the metadata of the file or folder | | | | | | |\n| Modify the content of the file | | | | | | |\n| Access historical revisions | | | | | | |\n| Add items to the folder | | | | | | |\n| Remove items from the My Drive folder | | | | | | |\n| Share items from the My Drive folder | | | | | | |\n| Can access detailed file permissions | | | | | | |\n| Move items into the trash | | | | | | |\n| Recover items from the trash | | | | | | |\n| Empty the trash | | | | | | |\n| Delete a file or folder | | | | | | |\n| Add a content restriction to a file in a My Drive folder | | | | | | |\n| Set or unset the limited access setting in My Drive folders | | | | | | |\n\nOperations specific to shared drives\n------------------------------------\n\nThe following table shows shared drive specific operations users can perform for\neach role, when the role isn't restricted to a view. For more information, see\n[Views](#views).\n\n| Permitted operation | `owner` | `organizer` | `fileOrganizer` | `writer` | `commenter` | `reader` |\n|-----------------------------------------------------------------|---------|-------------|-----------------|----------|-------------|----------|\n| Share a shared drive item | | | | | | |\n| Add files to shared drives | | | | | | |\n| Modify the metadata of a shared drive | | | | | | |\n| Add shared drive members | | | | | | |\n| Reorganize items within a shared drive \\[1\\] | | | | | | |\n| Move items outside of a shared drive \\[2\\] | | | | | | |\n| Delete items in shared drives \\[2\\] | | | | | | |\n| Delete an empty shared drive | | | | | | |\n| Add a content restriction to a file in a shared drive | | | | | | |\n| Set or unset the limited access setting in shared drive folders | | | | | | |\n\n| **\\[1\\]** Requires the `organizer` or `fileOrganizer` role on a direct or indirect parent, as opposed to the role being present on the item. \n| **\\[2\\]** Requires the `organizer` role on a direct or indirect parent, as opposed to the role being present on the item.\n\nCorrelation between Drive API and Drive UI roles\n------------------------------------------------\n\nThe Drive API and Drive UI use the same underlying\npermission system. However, the role names differ slightly between the two.\n\nThe following table shows how the roles correspond for files and folders in My\nDrive.\n\n| Drive API role | Drive UI role | Description |\n|----------------|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `owner` | Owner | Grants full control over the file or folder. |\n| `writer` | Editor | Grants the ability to view the file, add comments, and edit the file. For folders, can add, edit, and delete files or subfolders within that folder. |\n| `commenter` | Commenter | Grants the ability to view the file and add comments. |\n| `reader` | Viewer | Grants the ability to view the file. |\n\nThe following table shows how the roles correspond for files and folders in\nshared drives.\n\n| Drive API role | Drive UI role | Description |\n|-----------------|-----------------|--------------------------------------------------------------------------------------------------------------------|\n| `organizer` | Manager | Grants the ability to manage files, folders, people, and settings. |\n| `fileOrganizer` | Content Manager | Grants the ability to contribute and manage content. Default role for new members. |\n| `writer` | Contributor | Grants the ability to view the file, add comments, and edit the file. Can also create files within a shared drive. |\n| `commenter` | Commenter | Grants the ability to view the file and add comments. |\n| `reader` | Viewer | Grants the ability to view the file. |\n\nViews\n-----\n\nA permission might be restricted to a\n[`view`](/workspace/drive/api/reference/rest/v3/permissions#Permission.FIELDS.view), in which case\nthe role only applies to that particular view.\n\nA permission with `view=published` and `role=reader` grants `reader` access to\nthe published view of the file, but it doesn't grant `reader` access to the\nfile.\n\nA permission with `view=metadata` and `role=reader` grants `reader` access to\nthe metadata of the folder, but it doesn't grant access to the folder's\ncontents.\n\nConversely, any permission that's not restricted to a particular view, grants\n`reader` access to the published view of the file.\n\nRelated topics\n--------------\n\n- [Share files from Google Drive](https://support.google.com/docs/answer/2494822#zippy=%2Cunderstand-share-permissions)\n- [How file access works in shared drives](https://support.google.com/a/users/answer/12380484#access)"]]
