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 dokümanda, ortak sürüşe özgü API farklılıkları ana hatlarıyla açıklanmaktadır.

Dosya kaynağı

File kaynağındaki 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ği.
  • capabilities/canDeleteChildren: Geçerli kullanıcının bu klasörün alt öğelerini silip silemeyeceği.
  • capabilities/canMoveChildrenOutOfDrive: Mevcut 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: Mevcut kullanıcının, bu klasörün alt klasörlerini ortak Drive'da taşıyıp taşıyamayacağını belirtir.
  • capabilities/canMoveItemWithinDrive: Mevcut kullanıcının bu ortak Drive öğesini ortak Drive içinde 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 klasörlerini çöp kutusuna gönderip gönderemeyeceği.
  • driveId: Dosyanın bulunduğu ortak Drive'ın kimliği.
  • trashingUser: Dosya açıkça çöp kutusuna atılmışsa dosyayı çöp kutusuna atan kullanıcı.
  • trashedTime: Öğenin çöp kutusuna gönderildiği zaman. Eski Drive API v2 sürümünü kullanıyorsanız bu alanın adı trashedDate'tür.

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 veya ortak Drive klasöründeki bir dosyanın izinlerini listelemek için sayfalandırmayı destekleyen permissions.list() yöntemini kullanın.
  • owners, ownerNames, ownedByMe: Ortak Drive'daki dosyaların sahibi, bireysel kullanıcılar değil ortak Drive'dır.
  • 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 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östermeniz 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 ebeveyne erişimi yoksa ebeveyn, ebeveyn listesinde görünmez. Ayrıca, dosya 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.

İzin kaynağı

Permission kaynağındaki permissionDetails alanı yalnızca ortak Drive'da bulunan dosyalar için doldurulur. Bu alan, bu ortak Drive dosyasında etkin olan 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ımlandı.
  • permissions.list() yöntemi sayfalandırmayı destekler.

Kaynağı değiştirme

Ortak Drive'ın Change kaynağında aşağıdaki yeni alanlar kullanılabilir:

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

İçerikleri ortak Drive ile 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.