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.

Panduan ini menguraikan perbedaan API khusus drive bersama di resource files dan changes.

Resource file

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

  • hasAugmentedPermissions: Apakah ada pengguna yang diberi akses file langsung ke 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 memindahkan turunan folder ini ke sampah.
  • driveId: ID drive bersama tempat file berada.
  • trashingUser: Jika file telah dihapus secara eksplisit, pengguna yang menghapusnya.
  • trashedTime: Waktu saat item dihapus ke sampah. Jika Anda menggunakan Drive API v2 yang lebih lama, kolom ini disebut trashedDate.

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

  • permissions: Karena potensi ukuran daftar kontrol akses (ACL) drive bersama, izin tidak ditampilkan sebagai bagian dari file. Gunakan metode permissions.list, yang mendukung penomoran halaman, untuk mencantumkan izin untuk file dalam folder drive bersama atau folder drive bersama.
  • owners, ownerNames, ownedByMe: File dalam drive bersama dimiliki oleh drive bersama, bukan pengguna perorangan.
  • folderColorRgb: Folder tidak dapat diberi warna satu per satu.
  • shared: Semua item di drive bersama dibagikan.
  • writersCanShare: Berbagi tidak dapat dibatasi menurut peran di drive bersama.

Kolom berikut hanya disetel jika pengguna telah diberi izin akses file pada suatu 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: Orang tua tidak muncul dalam daftar orang tua jika pengguna yang meminta bukan anggota drive bersama dan tidak memiliki akses ke orang tua. Selain itu, dengan pengecualian folder tingkat teratas, daftar induk harus berisi tepat satu item jika file berada dalam drive bersama.

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

Mengubah 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 terbaru dari drive bersama. 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.