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 pengguna diberi akses file langsung di file ini.
  • capabilities/canAddFolderFromAnotherDrive — Apakah pengguna saat ini dapat menambahkan folder dari drive lain (drive bersama yang berbeda 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 tempat file ini berada.
  • capabilities/canTrashChildren — Apakah pengguna saat ini dapat membuang turunan folder ini ke sampah.
  • 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 untuk file dalam drive bersama atau drive bersama itu sendiri.
  • owners, ownerNames, ownedByMe — File dalam drive bersama dimiliki oleh drive bersama, bukan pengguna individu.
  • folderColorRgb — Folder tidak dapat diberi warna satu per satu
  • 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 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; salah untuk folder tingkat teratas drive bersama.

  • parents — Induk tidak muncul dalam daftar induk jika pengguna yang meminta 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 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. Kemungkinan nilainya 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.