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

Ortak Drive'lar, Drive'ım bölümündeki farklı kuruluş, paylaşım ve sahiplik modellerini izler. Bu nedenle, ortak Drive'daki içeriklerde bazı Drive'ım işlemlerine izin verilmez. Bu dokümanda, ortak Drive'a özgü API farklılıkları açıklanmaktadır.

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 verilmeyeceği.
  • capabilities/canAddFolderFromAnotherDrive: Geçerli kullanıcının başka bir Drive'daki (farklı bir ortak Drive veya Drive'ım) klasörü bu klasöre 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 içinde taşıyıp taşıyamayacağını belirtir.
  • capabilities/canMoveItemWithinDrive - Geçerli kullanıcının bu ortak Drive öğesini ortak Drive'a taşıyıp taşıyamayacağını belirtir.
  • capabilities/canReadDrive — Mevcut 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 atıp atamayacağı.
  • driveId: Dosyanın bulunduğu ortak Drive'ın kimliği.
  • trashingUser: Dosya açıkça çöp kutusuna gönderildiyse çöp kutusuna gönderen kullanıcı.

  • trashedTime: Öğenin çöp kutusuna gönderilme zamanı.

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

  • permissions: Ortak Drive EKL'lerinin potansiyel boyutu nedeniyle izinler dosyaların bir parçası olarak döndürülmez. Ortak Drive'daki veya ortak Drive'daki bir dosyanın izinlerini listelemek için sayfalara ayırmayı destekleyen permissions.list yöntemini kullanın.
  • owners, ownerNames, ownedByMe: Ortak Drive'daki dosyalar bireysel 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ı role göre kısıtlamak şu an için mümkün değildir.

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

  • sharedWithMeDate
  • sharingUser

Aşağıdaki alanları ortak Drive'larla kullanırken özellikle dikkat etmeniz gerekir:

  • parents.isRoot: Bu alan yalnızca Drive'ım kök klasörü için doğru, ortak Drive üst düzey klasörü için yanlış değerini alır.

  • parents: İstekte bulunan kullanıcı ortak Drive'ın üyesi değilse ve üst öğeye erişimi yoksa üst öğe, üst öğe listesinde görünmez. Ayrıca, üst düzey klasör hariç olmak üzere, dosya ortak Drive'da yer alıyorsa üst düzey listesinin tam olarak bir öğe içermesi gerekir.

  • 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 bu dosya tarafından devralınan sıkıştırılmış İzinlerin listesidir. Bu alan yalnızca çıkış amaçlıdır ve yalnızca ortak Drive öğeleri için bulunur. Ayrıca,

  • organizer ve fileOrganizer için iki yeni rol tanımlandı.
  • permissions.list artık sayfalara ayırmayı destekliyor.

Changes kaynağı

Bir ortak Drive'ın Changes kaynağında aşağıdaki yeni alanlar kullanılabilir:

  • changeType: Değişikliğin 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üncellenmiş durumu. changeType, drive ise ve kullanıcı hâlâ ortak Drive'ın üyesiyse gösterilir.

Ortak Drive'larla içerik senkronize etmesi veya etkinlikleri izlemesi gereken uygulamalar için ek değişiklikler gerekli olabilir. Ayrıntılı bilgi için kullanıcılar ve ortak Drive'lar için değişiklikleri izleme başlıklı makaleyi inceleyin.