Perbedaan drive bersama versus Drive Saya API

Drive bersama mengikuti berbagai model organisasi, berbagi, dan kepemilikan dari Drive Saya. Oleh karena itu, beberapa operasi Drive Saya tidak diizinkan untuk konten di drive bersama. Dokumen ini menjelaskan perbedaan API khusus drive bersama.

Files resource

Kolom berikut hanya diisi untuk file yang berada dalam drive bersama:

  • hasAugmentedPermissions — Apakah ada pengguna yang diberi akses file langsung pada file ini.
  • capabilities/canAddFolderFromAnotherDrive — Apakah pengguna saat ini dapat menambahkan folder dari drive lain (drive bersama lain atau Drive Saya) ke folder ini.
  • capabilities/canDeleteChildren — Apakah pengguna saat ini dapat menghapus turunan folder ini.
  • capabilities/canMoveChildrenOutOfDrive — Apakah pengguna saat ini dapat memindahkan turunan folder ini ke luar drive bersama.
  • capabilities/canMoveChildrenWithinDrive — Apakah pengguna saat ini dapat memindahkan turunan folder ini dalam drive bersama.
  • capabilities/canMoveItemWithinDrive — Apakah pengguna saat ini dapat memindahkan item drive bersama ini dalam drive bersama.
  • capabilities/canReadDrive — Apakah pengguna saat ini memiliki akses baca ke drive bersama yang memiliki file ini.
  • capabilities/canTrashChildren — Apakah pengguna saat ini dapat membuang turunan folder ini atau tidak.
  • driveId — ID drive bersama tempat file berada.
  • trashingUser — Jika file telah dibuang secara eksplisit, pengguna yang membuangnya.

  • trashedTime — Waktu item dibuang.

Kolom berikut tidak diisi untuk file yang berada dalam drive bersama:

  • permissions — Karena potensi ukuran ACL drive bersama, izin tidak ditampilkan sebagai bagian dari file. Gunakan metode permissions.list, yang mendukung penomoran halaman, untuk mencantumkan izin file dalam drive bersama atau drive bersama itu sendiri.
  • owners, ownerNames, ownedByMe — File dalam drive bersama adalah milik drive bersama, bukan milik masing-masing pengguna.
  • folderColorRgb — Folder tidak dapat diberi warna secara terpisah
  • shared — Semua item di drive bersama dibagikan.
  • writersCanShare — Saat ini, Anda tidak dapat membatasi berbagi berdasarkan peran di drive bersama.

Kolom berikut hanya ditetapkan jika pengguna telah diberi izin akses file pada sebuah item:

  • sharedWithMeDate
  • sharingUser

Kolom berikut memerlukan pertimbangan khusus saat Anda menggunakannya dengan drive bersama:

  • parents.isRoot — Kolom ini hanya berlaku untuk folder root Drive Saya; salah untuk folder tingkat atas drive bersama.

  • parents — Induk tidak akan muncul di daftar induk jika pengguna yang memintanya bukan anggota drive bersama dan tidak memiliki akses ke induk. Selain itu, dengan pengecualian folder tingkat teratas, daftar induk harus berisi tepat satu item jika file tersebut berada dalam drive bersama.

  • capabilities/canRemoveChildren — Gunakan capabilities/canDeleteChildren atau capabilities/canTrashChildren.

Permissions resource

Kolom permissionDetails hanya diisi untuk file yang berada dalam drive bersama. Kolom ini adalah daftar Izin ringkas yang ada di atau diwarisi oleh file drive bersama ini. Kolom ini adalah kolom output-saja dan hanya ada untuk item drive bersama. Selain itu,

  • dua peran baru organizer dan fileOrganizer telah ditentukan.
  • permissions.list kini mendukung penomoran halaman.

Changes resource

Kolom baru berikut tersedia di resource Changes untuk drive bersama:

  • changeType — Jenis perubahan. Nilai yang mungkin adalah file dan drive.
  • driveId — ID drive bersama yang terkait dengan perubahan ini.
  • drive — Status drive bersama yang diperbarui. Tampilkan jika changeType adalah drive dan pengguna masih menjadi anggota drive bersama.

Perubahan tambahan mungkin diperlukan untuk aplikasi yang perlu menyinkronkan konten dengan drive bersama atau melacak aktivitas. Untuk mengetahui detailnya, lihat melacak perubahan untuk pengguna dan drive bersama.