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 menjelaskan perbedaan API khusus drive bersama.

Resource file

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

  • hasAugmentedPermissions: Apakah pengguna diberi akses file secara langsung pada 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 dihapus secara eksplisit, pengguna yang menghapusnya.
  • trashedTime: Waktu item dihapus. 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 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 folder drive bersama.
  • 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: 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 atas 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 teratas, daftar induk harus berisi persis satu item jika file berada dalam drive bersama.

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

Resource izin

Kolom permissionDetails di resource Permission hanya diisi untuk file yang berada dalam drive bersama. Kolom ini adalah 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.
  • Metode permissions.list() mendukung penomoran halaman.

Mengubah resource

Kolom baru berikut tersedia di resource Change 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.