REST Resource: drives

Resource: Drive

Representasi drive bersama.

Beberapa metode resource (seperti drives.update) memerlukan driveId. Gunakan metode drives.list untuk mengambil ID drive bersama.

Representasi JSON 
{
  "id": string,
  "name": string,
  "colorRgb": string,
  "kind": string,
  "backgroundImageLink": string,
  "capabilities": {
    "canAddChildren": boolean,
    "canComment": boolean,
    "canCopy": boolean,
    "canDeleteDrive": boolean,
    "canDownload": boolean,
    "canEdit": boolean,
    "canListChildren": boolean,
    "canManageMembers": boolean,
    "canReadRevisions": boolean,
    "canRename": boolean,
    "canRenameDrive": boolean,
    "canChangeDriveBackground": boolean,
    "canShare": boolean,
    "canChangeCopyRequiresWriterPermissionRestriction": boolean,
    "canChangeDomainUsersOnlyRestriction": boolean,
    "canChangeDriveMembersOnlyRestriction": boolean,
    "canChangeSharingFoldersRequiresOrganizerPermissionRestriction": boolean,
    "canResetDriveRestrictions": boolean,
    "canDeleteChildren": boolean,
    "canTrashChildren": boolean,
    "canChangeDownloadRestriction": boolean
  },
  "themeId": string,
  "backgroundImageFile": {
    "id": string,
    "xCoordinate": number,
    "yCoordinate": number,
    "width": number
  },
  "createdTime": string,
  "hidden": boolean,
  "restrictions": {
    "copyRequiresWriterPermission": boolean,
    "domainUsersOnly": boolean,
    "driveMembersOnly": boolean,
    "adminManagedRestrictions": boolean,
    "sharingFoldersRequiresOrganizerPermission": boolean,
    "downloadRestriction": {
      object (DownloadRestriction)
    }
  },
  "orgUnitId": string
}
Kolom
id

string

Hanya output. ID drive bersama ini yang juga merupakan ID folder tingkat teratas dari drive bersama ini.
name

string

Nama drive bersama ini.
colorRgb

string

Warna drive bersama ini sebagai string heksadesimal RGB. Parameter ini hanya dapat ditetapkan pada permintaan drive.drives.update yang tidak menetapkan themeId.
kind

string

Hanya output. Mengidentifikasi jenis resource ini. Nilai: string tetap "drive#drive".
capabilities

object

Hanya output. Kemampuan yang dimiliki pengguna saat ini di drive bersama ini.
capabilities.canAddChildren

boolean

Hanya output. Apakah pengguna saat ini dapat menambahkan turunan ke folder di drive bersama ini.
capabilities.canComment

boolean

Hanya output. Apakah pengguna saat ini dapat memberi komentar pada file di drive bersama ini.
capabilities.canCopy

boolean

Hanya output. Apakah pengguna saat ini dapat menyalin file di drive bersama ini.
capabilities.canDeleteDrive

boolean

Hanya output. Apakah pengguna saat ini dapat menghapus drive bersama ini. Upaya menghapus drive bersama mungkin tetap gagal jika ada item yang belum dipulihkan di dalam drive bersama.
capabilities.canDownload

boolean

Hanya output. Apakah pengguna saat ini dapat mendownload file di drive bersama ini.
capabilities.canEdit

boolean

Hanya output. Apakah pengguna saat ini dapat mengedit file di drive bersama ini
capabilities.canListChildren

boolean

Hanya output. Apakah pengguna saat ini dapat mencantumkan turunan folder di drive bersama ini.
capabilities.canManageMembers

boolean

Hanya output. Apakah pengguna saat ini dapat menambahkan anggota ke drive bersama ini atau menghapusnya atau mengubah perannya.
capabilities.canReadRevisions

boolean

Hanya output. Apakah pengguna saat ini dapat membaca resource revisi file di drive bersama ini.
capabilities.canRename

boolean

Hanya output. Apakah pengguna saat ini dapat mengganti nama file atau folder di drive bersama ini.
capabilities.canRenameDrive

boolean

Hanya output. Apakah pengguna saat ini dapat mengganti nama drive bersama ini.
capabilities.canChangeDriveBackground

boolean

Hanya output. Apakah pengguna saat ini dapat mengubah latar belakang drive bersama ini.
capabilities.canShare

boolean

Hanya output. Apakah pengguna saat ini dapat membagikan file atau folder di drive bersama ini.
capabilities.canChangeCopyRequiresWriterPermissionRestriction

boolean

Hanya output. Apakah pengguna saat ini dapat mengubah pembatasan copyRequiresWriterPermission pada drive bersama ini.
capabilities.canChangeDomainUsersOnlyRestriction

boolean

Hanya output. Apakah pengguna saat ini dapat mengubah pembatasan domainUsersOnly pada drive bersama ini.
capabilities.canChangeDriveMembersOnlyRestriction

boolean

Hanya output. Apakah pengguna saat ini dapat mengubah pembatasan driveMembersOnly pada drive bersama ini.
capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

Hanya output. Apakah pengguna saat ini dapat mengubah pembatasan sharingFoldersRequiresOrganizerPermission pada drive bersama ini.
capabilities.canResetDriveRestrictions

boolean

Hanya output. Apakah pengguna saat ini dapat mereset pembatasan drive bersama ke setelan default.
capabilities.canDeleteChildren

boolean

Hanya output. Apakah pengguna saat ini dapat menghapus turunan dari folder di drive bersama ini.
capabilities.canTrashChildren

boolean

Hanya output. Apakah pengguna saat ini dapat menghapus turunan dari folder di drive bersama ini.
capabilities.canChangeDownloadRestriction

boolean

Hanya output. Apakah pengguna saat ini dapat mengubah pembatasan download yang diterapkan penyelenggara pada drive bersama ini.
themeId

string

ID tema yang akan digunakan untuk menetapkan gambar dan warna latar belakang. Kumpulan kemungkinan driveThemes dapat diambil dari respons drive.about.get. Jika tidak ditentukan pada permintaan drive.drives.create, tema acak akan dipilih untuk menetapkan gambar dan warna latar belakang. Ini adalah kolom hanya tulis; kolom ini hanya dapat ditetapkan pada permintaan yang tidak menetapkan colorRgb atau backgroundImageFile.
backgroundImageFile

object

File gambar dan parameter pemangkasan yang digunakan untuk menetapkan gambar latar belakang untuk drive bersama ini. Ini adalah kolom hanya tulis; kolom ini hanya dapat ditetapkan pada permintaan drive.drives.update yang tidak menetapkan themeId. Jika ditentukan, semua kolom backgroundImageFile harus ditetapkan.
backgroundImageFile.id

string

ID file gambar di Google Drive yang akan digunakan untuk gambar latar belakang.
backgroundImageFile.xCoordinate

number

Koordinat X dari sudut kiri atas area pemangkasan di gambar latar belakang. Ini adalah nilai dalam rentang tertutup 0 hingga 1. Nilai ini menunjukkan jarak horizontal dari sisi kiri seluruh gambar ke sisi kiri area pemangkasan dibagi dengan lebar seluruh gambar.
backgroundImageFile.yCoordinate

number

Koordinat Y dari sudut kiri atas area pemangkasan di gambar latar belakang. Ini adalah nilai dalam rentang tertutup 0 hingga 1. Nilai ini mewakili jarak vertikal dari sisi atas seluruh gambar ke sisi atas area pemangkasan dibagi dengan tinggi seluruh gambar.
backgroundImageFile.width

number

Lebar gambar yang dipangkas dalam rentang tertutup 0 hingga 1. Nilai ini mewakili lebar gambar yang dipangkas dibagi dengan lebar seluruh gambar. Tingginya dihitung dengan menerapkan rasio aspek lebar terhadap tinggi 80 banding 9. Gambar yang dihasilkan harus memiliki lebar minimal 1.280 piksel dan tinggi minimal 144 piksel.
createdTime

string

Hanya output. Waktu saat drive bersama dibuat (tanggal dan waktu RFC 3339).
hidden

boolean

Apakah drive bersama disembunyikan dari tampilan default.
restrictions

object

Serangkaian batasan yang berlaku untuk drive bersama ini atau item di dalam drive bersama ini. Perhatikan bahwa pembatasan tidak dapat disetel saat membuat drive bersama. Untuk menambahkan batasan, buat drive bersama terlebih dahulu, lalu gunakan drives.update untuk menambahkan batasan.
restrictions.copyRequiresWriterPermission

boolean

Apakah opsi untuk menyalin, mencetak, atau mendownload file di dalam drive bersama ini harus dinonaktifkan untuk pembaca dan pengomentar. Jika setelan pembatasan ini ditetapkan ke true, setelan ini akan menggantikan kolom dengan nama serupa menjadi true untuk file apa pun di dalam drive bersama ini.
restrictions.domainUsersOnly

boolean

Apakah akses ke drive bersama ini dan item di dalamnya dibatasi untuk pengguna domain tempat drive bersama ini berada. Pembatasan ini dapat diganti oleh kebijakan berbagi lain yang dikontrol di luar drive bersama ini.
restrictions.driveMembersOnly

boolean

Apakah akses ke item di dalam drive bersama ini dibatasi untuk anggotanya.
restrictions.adminManagedRestrictions

boolean

Apakah hak istimewa administratif di drive bersama ini diperlukan untuk mengubah batasan.
restrictions.sharingFoldersRequiresOrganizerPermission

boolean

Jika benar, hanya pengguna dengan peran penyelenggara yang dapat membagikan folder. Jika salah (false), pengguna dengan peran penyelenggara atau peran penyelenggara file dapat membagikan folder.
restrictions.downloadRestriction

object (DownloadRestriction)

Pembatasan download yang diterapkan oleh pengelola drive bersama.
orgUnitId

string

Hanya output. Unit organisasi drive bersama ini. Kolom ini hanya diisi pada respons drives.list jika parameter useDomainAdminAccess ditetapkan ke true.

Metode

create

 Membuat drive bersama.

delete

 Menghapus drive bersama secara permanen yang pengguna tersebut merupakan organizer-nya.

get

 Mendapatkan metadata drive bersama berdasarkan ID.

hide

 Menyembunyikan drive bersama dari tampilan default.

list

Mencantumkan drive bersama pengguna.

unhide

 Memulihkan tampilan default drive bersama.

update

 Memperbarui metadata untuk drive bersama.