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
  },
  "themeId": string,
  "backgroundImageFile": {
    "id": string,
    "xCoordinate": number,
    "yCoordinate": number,
    "width": number
  },
  "createdDate": string,
  "hidden": boolean,
  "restrictions": {
    "copyRequiresWriterPermission": boolean,
    "domainUsersOnly": boolean,
    "driveMembersOnly": boolean,
    "adminManagedRestrictions": boolean,
    "sharingFoldersRequiresOrganizerPermission": boolean
  },
  "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. Nilai ini hanya dapat ditetapkan pada permintaan drive.drives.update yang tidak menetapkan themeId.
kind

string

Hanya output. Nilai ini selalu 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 untuk menghapus drive bersama mungkin masih gagal jika ada item yang tidak dihapus dari sampah 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 drive bersama ini.
capabilities.canChangeDomainUsersOnlyRestriction

boolean

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

boolean

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

boolean

Hanya output. Apakah pengguna saat ini dapat mengubah pembatasan sharingFoldersRequiresOrganizerPermission 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 item turunan dari folder di drive bersama ini.
themeId

string

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

object

File gambar dan parameter pemangkasan yang digunakan untuk menetapkan gambar latar untuk drive bersama ini. Ini adalah kolom hanya tulis; 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 yang 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. Tinggi dihitung dengan menerapkan rasio lebar tinggi 80 banding 9. Gambar yang dihasilkan harus memiliki lebar minimal 1.280 piksel dan tinggi minimal 144 piksel.
createdDate

string

Hanya output. Waktu pembuatan drive bersama (waktu tanggal RFC 3339).
hidden

boolean

Apakah drive bersama disembunyikan dari tampilan default.
restrictions

object

Kumpulan batasan yang berlaku untuk drive bersama ini atau item di dalam drive bersama ini.
restrictions.copyRequiresWriterPermission

boolean

Apakah opsi untuk menyalin, mencetak, atau mendownload file di dalam drive bersama ini harus dinonaktifkan untuk pembaca dan pengomentar. Jika pembatasan ini ditetapkan ke true, pembatasan tersebut akan mengganti kolom yang bernama sama dengan true untuk file apa pun di dalam drive bersama ini.
restrictions.domainUsersOnly

boolean

Apakah akses ke drive bersama ini dan item di dalam drive bersama ini dibatasi untuk pengguna domain tempat drive bersama ini berada. Batasan 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, pengguna dengan peran penyelenggara atau peran penyelenggara file dapat membagikan folder.
orgUnitId

string

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

Metode

delete

 Menghapus drive bersama secara permanen yang penggunanya adalah organizer.

get

 Mendapatkan metadata drive bersama berdasarkan ID.

hide

 Menyembunyikan drive bersama dari tampilan default.

insert

 Membuat drive bersama baru.

list

Mencantumkan drive bersama pengguna.

unhide

 Memulihkan drive bersama ke tampilan default.

update

 Memperbarui metadata untuk drive bersama.