REST Resource: drives

Referensi: 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
  },
  "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. Ini hanya dapat disetel berdasarkan 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 mencantumkan turunan folder di drive bersama ini.

capabilities.canManageMembers

boolean

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

capabilities.canReadRevisions

boolean

Hanya output. Apakah pengguna saat ini dapat membaca referensi 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 batasan drive bersama ke 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 memindahkan turunan dari folder di drive bersama ini atau tidak.

themeId

string

ID tema yang digunakan untuk menetapkan gambar latar dan warna. Kumpulan kemungkinan driveThemes dapat diambil dari respons drive.about.get. Jika tidak ditentukan pada permintaan drive.drives.create, tema acak dipilih tempat gambar latar dan warna 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 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 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 batasan ini disetel ke true, batasan ini akan mengganti kolom dengan nama yang mirip dengan true untuk file apa pun dalam drive bersama ini.

restrictions.domainUsersOnly

boolean

Apakah akses ke drive bersama 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 hanya 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 berbagi 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 saat 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 metadate untuk drive bersama.