Ortak Drive ile Drive'ım API'si arasındaki farklar
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Ortak Drive'lar, Drive'ım'dan farklı kuruluş, paylaşım ve sahiplik modellerini kullanır. Bu nedenle, Drive'ım ile ilgili bazı işlemler ortak Drive'daki içerikler için kullanılamaz.
Bu kılavuzda, files ve changes kaynaklarındaki ortak drive'a özgü API farklılıkları açıklanmaktadır.
Dosya kaynağı
files kaynağındaki aşağıdaki alanlar yalnızca ortak Drive'da bulunan dosyalar için doldurulur:
hasAugmentedPermissions: Kullanıcılara bu dosyaya doğrudan dosya erişimi verilip verilmediği.capabilities/canAddFolderFromAnotherDrive: Geçerli kullanıcının, bu klasöre başka bir Drive'dan (farklı bir ortak Drive veya Drive'ım) klasör ekleyip ekleyemeyeceğini belirtir.capabilities/canDeleteChildren: Geçerli kullanıcının bu klasörün alt öğelerini silip silemeyeceğini belirtir.capabilities/canMoveChildrenOutOfDrive: Geçerli kullanıcının bu klasörün alt öğelerini ortak Drive'ın dışına taşıyıp taşıyamayacağını belirtir.capabilities/canMoveChildrenWithinDrive: Geçerli kullanıcının bu klasörün alt öğelerini ortak Drive'da taşıyıp taşıyamayacağını belirtir.capabilities/canMoveItemWithinDrive: Geçerli kullanıcının bu ortak Drive öğesini ortak Drive içinde taşıyıp taşıyamayacağını belirtir.capabilities/canReadDrive: Geçerli kullanıcının, bu dosyanın ait olduğu ortak Drive'a okuma erişimi olup olmadığını belirtir.capabilities/canTrashChildren: Geçerli kullanıcının bu klasörün alt öğelerini çöp kutusuna taşıyıp taşıyamayacağını belirtir.driveId: Dosyanın bulunduğu ortak Drive'ın kimliği.trashingUser: Dosya açıkça silindiyse dosyayı silen kullanıcı.trashedTime: Öğenin çöp kutusuna gönderildiği zaman. Daha eski olan Drive API v2'yi kullanıyorsanız bu alanın adı trashedDate'dir.
Ortak Drive'da bulunan dosyalar için aşağıdaki alanlar doldurulmaz:
permissions: Ortak Drive erişim kontrol listelerinin (EKL'ler) boyutu büyük olabileceğinden izinler dosyaların bir parçası olarak döndürülmez. Ortak Drive'daki bir dosya veya ortak Drive klasörü için izinleri listelemek üzere sayfalama özelliğini destekleyen permissions.list yöntemini kullanın.owners, ownerNames, ownedByMe: Ortak Drive'daki dosyalar, tek tek kullanıcılara değil, ortak Drive'a aittir.folderColorRgb: Klasörler tek tek renklendirilemez.shared: Ortak Drive'daki tüm öğeler paylaşılır.writersCanShare: Ortak drive'larda role göre paylaşımı kısıtlamak mümkün değildir.
Aşağıdaki alanlar yalnızca kullanıcıya bir öğede dosya erişimi izinleri verildiğinde ayarlanır:
sharedWithMeDatesharingUser
Aşağıdaki alanlar, paylaşılan sürücülerle birlikte kullanıldığında özel dikkat gerektirir:
parents.isRoot: Bu alan yalnızca Drive'ım kök klasörü için doğrudur. Ortak Drive'ın üst düzey klasörü için yanlıştır.parents: İstekte bulunan kullanıcı, ortak Drive'ın üyesi değilse ve ebeveyne erişimi yoksa ebeveynler listesinde görünmez. Ayrıca, dosya bir ortak drive'da bulunuyorsa üst düzey klasör hariç olmak üzere üst öğeler listesi tam olarak bir öğe içermelidir.
capabilities/canRemoveChildren: capabilities/canDeleteChildren veya capabilities/canTrashChildren kullanın.
Kaynağı değiştirme
Bir ortak Drive'ın changes kaynağında aşağıdaki yeni alanlar kullanılabilir:
changeType: Değişiklik türü. Olası değerler file ve drive'dir.driveId: Bu değişiklikle ilişkili ortak drive'ın kimliği.drive: Ortak Drive'ın güncellenen durumu. changeType
ise drive ve kullanıcı ortak Drive'ın üyesi olmaya devam ediyorsa gösterilir.
İçeriği ortak Drive'larla senkronize etmesi veya etkinliği izlemesi gereken uygulamalar için ek değişiklikler gerekebilir. Ayrıntılı bilgi için Kullanıcılar ve ortak drive'lar için değişiklikleri izleme başlıklı makaleyi inceleyin.
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-29 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-29 UTC."],[],[],null,["# Shared drive versus My Drive API differences\n\nShared drives follow different organization, sharing, and ownership models from\na My Drive. As such, some My Drive operations\naren't permitted for content in a shared drive.\n\nThis guide outlines shared drive-specific API differences in the `files` and\n`changes` resources.\n\nFile resource\n-------------\n\nThe following fields in the [`files`](/workspace/drive/api/reference/rest/v3/files) resource are\nonly populated for files located within a shared drive:\n\n- `hasAugmentedPermissions`: Whether any users are granted file access directly on this file.\n- `capabilities/canAddFolderFromAnotherDrive`: Whether the current user can add a folder from another drive (a different shared drive or My Drive) to this folder.\n- `capabilities/canDeleteChildren`: Whether the current user can delete children of this folder.\n- `capabilities/canMoveChildrenOutOfDrive`: Whether the current user can move children of this folder outside of the shared drive.\n- `capabilities/canMoveChildrenWithinDrive`: Whether the current user can move children of this folder within the shared drive.\n- `capabilities/canMoveItemWithinDrive`: Whether the current user can move this shared drive item within the shared drive.\n- `capabilities/canReadDrive`: Whether the current user has read access to the shared drive to which this file belongs.\n- `capabilities/canTrashChildren`: Whether the current user can trash children of this folder.\n- `driveId`: The ID of the shared drive where the file is located.\n- `trashingUser`: If the file has been explicitly trashed, the user who trashed it.\n- `trashedTime`: The time that the item was trashed. If you're using the older Drive API v2, this field is called `trashedDate`.\n\nThe following fields aren't populated for files located within a shared drive:\n\n- `permissions`: Due to the potential size of shared drive access control lists (ACLs), permissions aren't returned as part of files. Use the `permissions.list` method, which supports pagination, to list permissions for a file within a shared drive or the shared drive folder.\n- `owners`, `ownerNames`, `ownedByMe`: Files within a shared drive are owned by the shared drive, not individual users.\n- `folderColorRgb`: Folders cannot be colored individually.\n- `shared`: All items in a shared drive are shared.\n- `writersCanShare`: It's not possible to restrict sharing by role in shared drives.\n\nThe following fields are only set when the user has been granted file access\npermissions on an item:\n\n- `sharedWithMeDate`\n- `sharingUser`\n\nThe following fields require special consideration when you use them with shared\ndrives:\n\n- `parents.isRoot`: This field is only true for the My Drive root folder; it's false for the shared drive top-level folder.\n- `parents`: A parent doesn't appear in the parents list if the requesting\n user isn't a member of the shared drive and doesn't have access to the\n parent. In addition, with the exception of the top level folder, the parents\n list must contain exactly one item if the file is located within a shared\n drive.\n\n | **Note:** If you're using the older Drive API v2:\n | - `shareable`: Deprecated. Use `capabilities/canShare`.\n | - `editable`: Deprecated. Use `capabilities/canEdit`.\n | - `copyable`: Deprecated. Use `capabilities/canCopy`.\n | - `canComment`: Deprecated. Use `capabilities/canComment`.\n | - `canReadRevisions`: Deprecated. Use `capabilities/canReadRevisions`.\n- `capabilities/canRemoveChildren`: Use `capabilities/canDeleteChildren` or\n `capabilities/canTrashChildren`.\n\nChange resource\n---------------\n\nThe following new fields are available in the\n[`changes`](/workspace/drive/api/reference/rest/v3/changes) resource for a shared drive:\n\n- `changeType`: The change type. Possible values are `file` and `drive`.\n- `driveId`: The ID of the shared drive associated with this change.\n- `drive`: The updated state of the shared drive. Present if the `changeType` is `drive` and the user is still a member of the shared drive.\n\nAdditional changes might be required for applications that need to sync content\nwith shared drives or track activity. For details, see [Track changes for users\nand shared drives](/workspace/drive/api/guides/about-changes).\n\nRelated topics\n--------------\n\n- [Files and folders overview](/workspace/drive/api/guides/about-files)\n- [Changes and revisions overview](/workspace/drive/api/guides/change-overview)"]]
