REST Resource: drives

Referensi: Drive

Representasi drive bersama.

Beberapa metode resource (seperti drives.update) memerlukan driveId. Gunakan metode drives.list untuk mengambil ID untuk 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
  },
  "createdTime": 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 drive bersama ini.
name

string

Nama drive bersama ini.
colorRgb

string

Warna drive bersama ini sebagai string heksadesimal RGB. Class ini hanya dapat disetel 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 akun anak 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 dibuang 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 menampilkan daftar turunan folder di drive bersama ini.
capabilities.canManageMembers

boolean

Hanya output. Apakah pengguna saat ini dapat menambahkan anggota ke drive bersama ini, 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 berbagi file atau folder di drive bersama ini.
capabilities.canChangeCopyRequiresWriterPermissionRestriction

boolean

Hanya output. Apakah pengguna saat ini dapat mengubah batasan copyRequiresWriterPermission di drive bersama ini.
capabilities.canChangeDomainUsersOnlyRestriction

boolean

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

boolean

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

boolean

Hanya output. Apakah pengguna saat ini dapat mengubah batasan sharingFoldersRequiresOrganizerPermission di drive bersama ini.
capabilities.canResetDriveRestrictions

boolean

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

boolean

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

boolean

Hanya output. Apakah pengguna saat ini dapat memindahkan turunan dari folder di drive bersama ini.
themeId

string

ID tema tempat gambar dan warna latar akan ditetapkan. Kumpulan kemungkinan driveThemes dapat diambil dari respons drive.about.get. Jika tidak ditentukan pada permintaan drive.drives.create, tema acak akan dipilih yang gambar latar dan warnanya ditetapkan. 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 menyetel gambar latar 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 sebagai gambar latar.
backgroundImageFile.xCoordinate

number

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

number

Koordinat Y dari sudut kiri atas area pemangkasan pada gambar latar. 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. Tinggi dihitung dengan menerapkan rasio aspek lebar ke tinggi 80 hingga 9. Gambar yang dihasilkan harus memiliki lebar minimal 1280 piksel dan tinggi minimal 144 piksel.
createdTime

string

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

boolean

Apakah drive bersama disembunyikan dari tampilan default.
restrictions

object

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

boolean

Opsi untuk menyalin, mencetak, atau mendownload file di dalam drive bersama ini harus dinonaktifkan bagi pembaca dan pengomentar. Jika disetel ke true, batasan ini akan mengganti kolom dengan nama serupa ke 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 mungkin 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 pengelola atau pengelola 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

create

 Membuat drive bersama.

delete

 Menghapus drive bersama yang penggunanya adalah organizer secara permanen.

get

 Mendapatkan metadata drive bersama berdasarkan ID.

hide

 Menyembunyikan drive bersama dari tampilan default.

list

Mencantumkan drive bersama pengguna.

unhide

 Memulihkan drive bersama ke tampilan default.

update

 Memperbarui metadata untuk drive bersama.