Ortak Drive ile Drive'ım API'si arasındaki farklar

Ortak Drive'lar, Drive'ım'dan farklı kuruluş, paylaşım ve sahiplik modellerini kullanır. Bu nedenle, ortak Drive'daki içerikler için bazı Drive'ım işlemlerine izin verilmez. Bu belgede, ortak Drive'a özgü API farklılıkları özetlenmiştir.

Files kaynağı

Aşağıdaki alanlar yalnızca ortak Drive'da bulunan dosyalar için doldurulur:

  • hasAugmentedPermissions: Kullanıcılara doğrudan bu dosyaya 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ği.
  • capabilities/canMoveChildrenOutOfDrive: Geçerli kullanıcının bu klasörün alt klasörlerini 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ğı.
  • 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ığı.
  • capabilities/canTrashChildren: Geçerli kullanıcının bu klasörün alt öğelerini çöp kutusuna gönderip gönderemeyeceği.
  • driveId: Dosyanın bulunduğu ortak Drive'ın kimliği.
  • trashingUser: Dosya açıkça çöp kutusuna taşındıysa dosyayı çöp kutusuna taşıyan kullanıcı.

  • trashedTime: Öğenin çöp kutusuna gönderildiği zaman.

Ortak Drive'da bulunan dosyalar için aşağıdaki alanlar doldurulmaz:

  • permissions: Ortak Drive ACL'lerinin olası boyutu nedeniyle izinler, dosyaların bir parçası olarak döndürülmez. Bir ortak Drive'daki bir dosyanın veya ortak Drive'ın izinlerini listelemek için sayfalandırmayı destekleyen permissions.list yöntemini kullanın.
  • owners, ownerNames, ownedByMe: Ortak Drive'daki dosyalar, 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 paylaşımı rol bazında kısıtlamak şu anda mümkün değildir.

Aşağıdaki alanlar yalnızca kullanıcıya bir öğe üzerinde dosya erişim izinleri verildiğinde ayarlanır:

  • sharedWithMeDate
  • sharingUser

Aşağıdaki alanları paylaşılan sürücülerle kullanırken özel dikkat gösterilmesi gerekir:

  • parents.isRoot: Bu alan yalnızca Drive'ım kök klasörü için doğrudur. Ortak Drive üst düzey klasörü için yanlıştır.

  • parents: İstekte bulunan kullanıcı ortak Drive'ın üyesi değilse ve üst öğeye erişimi yoksa üst öğe, üst öğeler listesinde görünmez. Ayrıca, dosya paylaşılan bir sürücüdeyse ü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.

Permissions kaynağı

permissionDetails alanı yalnızca ortak Drive'da bulunan dosyalar için doldurulur. Bu alan, bu ortak Drive dosyasında bulunan veya dosya tarafından devralınan sıkıştırılmış izinlerin listesidir. Bu alan yalnızca çıkış alanıdır ve yalnızca ortak Drive öğeleri için mevcuttur. Ayrıca,

  • organizer ve fileOrganizer adlı iki yeni rol tanımlanmıştır.
  • permissions.list artık sayfalandırmayı destekliyor.

Changes kaynağı

Paylaşılan sürücülerin Changes kaynağında aşağıdaki yeni alanlar kullanılabilir:

  • changeType: Değişikliğin türü. Olası değerler file ve drive'dur.
  • driveId: Bu değişiklikle ilişkili ortak Drive'ın kimliği.
  • drive: Ortak Drive'ın güncel durumu. changeType drive ise ve kullanıcı hâlâ ortak Drive'ın üyesiyse mevcuttur.

İçerikleri 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ı ve ortak Drive'lardaki değişiklikleri izleme başlıklı makaleyi inceleyin.