Perbedaan drive bersama versus Drive Saya API

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

Files resource

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

  • hasAugmentedPermissions — Apakah ada pengguna diberi akses file langsung pada file ini atau tidak.
  • capabilities/canAddFolderFromAnotherDrive — Apakah pengguna saat ini dapat menambahkan folder dari drive lain (drive bersama atau Drive Saya yang berbeda) 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 di dalam drive bersama.
  • capabilities/canMoveItemWithinDrive — Apakah pengguna saat ini dapat memindahkan item drive bersama ini di dalam drive bersama.
  • capabilities/canReadDrive — Apakah pengguna saat ini memiliki akses baca ke drive bersama tempat file ini berada.
  • capabilities/canTrashChildren — Apakah pengguna saat ini dapat memindahkan turunan folder ini ke sampah.
  • driveId — ID drive bersama tempat file berada.
  • trashingUser — Jika file telah dihapus 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 dimiliki oleh drive bersama, bukan pengguna perorangan.
  • folderColorRgb — Folder tidak dapat diwarnai satu per satu
  • shared — Semua item di drive bersama dibagikan.
  • writersCanShare — Saat ini, berbagi berdasarkan peran di drive bersama tidak dapat dibatasi.

Kolom berikut hanya ditetapkan saat 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 benar untuk folder root Drive Saya, dan salah untuk folder tingkat teratas drive bersama.

  • parents — Induk tidak muncul di daftar induk jika pengguna yang memintanya bukan anggota drive bersama dan tidak memiliki akses ke induk. Selain itu, dengan pengecualian folder tingkat atas, daftar induk harus berisi tepat satu item jika file 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 berisi daftar Izin ringkas yang aktif atau diwarisi oleh file drive bersama ini. Kolom ini adalah kolom khusus output 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. Kemungkinan nilainya adalah file dan drive.
  • driveId — ID drive bersama yang terkait dengan perubahan ini.
  • drive — Status drive bersama yang diperbarui. Ditampilkan 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.