REST Resource: drives

Resource: 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. Kolom 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 masih dapat gagal jika ada item yang tidak 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 mencantumkan 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 drive bersama ini.

capabilities.canChangeDomainUsersOnlyRestriction

boolean

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

capabilities.canChangeDriveMembersOnlyRestriction

boolean

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

capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

Hanya output. Apakah pengguna saat ini dapat mengubah batasan 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 membuang turunan dari folder di drive bersama ini.

themeId

string

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

backgroundImageFile

object

File gambar dan parameter pemangkasan yang menjadi sumber setelan gambar latar untuk drive bersama ini. Ini adalah isian hanya tulis; itu hanya dapat disetel pada permintaan drive.drives.update yang tidak menyetel themeId. Jika ditentukan, semua kolom backgroundImageFile harus ditetapkan.

backgroundImageFile.id

string

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

backgroundImageFile.xCoordinate

number

Koordinat X sudut kiri atas area pemangkasan pada gambar latar. Ini adalah nilai dalam rentang tertutup dari 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 sudut kiri atas area pemangkasan pada gambar latar. Ini adalah nilai dalam rentang tertutup dari 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 aspek lebar hingga tinggi dari 80 hingga 9. Gambar yang dihasilkan harus memiliki lebar minimal 1.280 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. Perhatikan 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

Apakah opsi untuk menyalin, mencetak, atau mendownload file di dalam drive bersama ini harus dinonaktifkan bagi pembaca dan pengomentar. Jika ditetapkan ke true, pembatasan ini akan menggantikan kolom dengan nama yang mirip 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 yang memiliki drive bersama ini. 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 pembatasan.

restrictions.sharingFoldersRequiresOrganizerPermission

boolean

Jika true (benar), hanya pengguna dengan peran penyelenggara yang dapat membagikan folder. Jika salah (false), pengguna dengan peran pengelola atau peran 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 secara permanen drive bersama yang penggunanya adalah organizer.

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.