Resource: File
Metadata untuk file.
Beberapa metode resource (seperti files.update
) memerlukan fileId
. Gunakan metode files.list
untuk mengambil ID file.
Representasi JSON |
---|
{ "kind": string, "driveId": string, "fileExtension": string, "copyRequiresWriterPermission": boolean, "md5Checksum": string, "contentHints": { "indexableText": string, "thumbnail": { "image": string, "mimeType": string } }, "writersCanShare": boolean, "viewedByMe": boolean, "mimeType": string, "exportLinks": { string: string, ... }, "parents": [ string ], "thumbnailLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object ( |
Kolom | |
---|---|
kind |
Hanya output. Mengidentifikasi jenis resource ini. Nilai: string tetap |
drive |
Hanya output. ID drive bersama tempat file berada. Hanya diisi untuk item di drive bersama. |
file |
Hanya output. Komponen terakhir dari |
copy |
Apakah opsi untuk menyalin, mencetak, atau mendownload file ini harus dinonaktifkan untuk pembaca dan komentator. |
md5 |
Hanya output. Checksum MD5 untuk konten file. Hal ini hanya berlaku untuk file dengan konten biner di Google Drive. |
content |
Informasi tambahan tentang konten file. Kolom ini tidak pernah diisi dalam respons. |
content |
Teks yang akan diindeks untuk file guna meningkatkan kueri fullText. Panjangnya dibatasi hingga 128 KB dan dapat berisi elemen HTML. |
content |
Thumbnail untuk file. Ini hanya akan digunakan jika Google Drive tidak dapat membuat thumbnail standar. |
content |
Data thumbnail yang dienkode dengan Base64 aman untuk URL (RFC 4648 bagian 5). String berenkode base64. |
content |
Jenis MIME thumbnail. |
writers |
Apakah pengguna yang hanya memiliki izin |
viewed |
Hanya output. Apakah file telah dilihat oleh pengguna ini. |
mime |
Jenis MIME file. Google Drive akan otomatis mendeteksi nilai yang sesuai dari konten yang diupload, jika tidak ada nilai yang diberikan. Nilai tidak dapat diubah kecuali jika revisi baru diupload. Jika file dibuat dengan jenis MIME Google Dokumen, konten yang diupload akan diimpor, jika memungkinkan. Format impor yang didukung dipublikasikan di resource Tentang. |
export |
Hanya output. Link untuk mengekspor file Editor Dokumen ke format tertentu. Objek yang berisi daftar pasangan |
parents[] |
ID folder induk yang berisi file. File hanya dapat memiliki satu folder induk; menentukan beberapa induk tidak didukung. Jika tidak ditentukan sebagai bagian dari permintaan pembuatan, file akan ditempatkan langsung di folder Drive Saya milik pengguna. Jika tidak ditentukan sebagai bagian dari permintaan salinan, file akan mewarisi induk file sumber yang dapat ditemukan. Permintaan files.update harus menggunakan parameter |
thumbnail |
Hanya output. Link berumur pendek ke thumbnail file, jika tersedia. Biasanya berlangsung selama beberapa jam. Tidak dimaksudkan untuk penggunaan langsung di aplikasi web karena kebijakan Cross-Origin Resource Sharing (CORS), pertimbangkan untuk menggunakan server proxy. Hanya diisi jika aplikasi yang meminta dapat mengakses konten file. Jika file tidak dibagikan secara publik, URL yang ditampilkan di |
icon |
Hanya output. Link statis yang tidak diautentikasi ke ikon file. |
shared |
Hanya output. Apakah file telah dibagikan. Tidak diisi untuk item di drive bersama. |
last |
Hanya output. Pengguna terakhir yang mengubah file. Kolom ini hanya diisi jika modifikasi terakhir dilakukan oleh pengguna yang login. |
owners[] |
Hanya output. Pemilik file ini. Hanya file lama tertentu yang dapat memiliki lebih dari satu pemilik. Kolom ini tidak diisi untuk item di drive bersama. |
head |
Hanya output. ID revisi kepala file. Saat ini, fitur ini hanya tersedia untuk file dengan konten biner di Google Drive. |
sharing |
Hanya output. Pengguna yang membagikan file kepada pengguna yang meminta, jika berlaku. |
web |
Hanya output. Link untuk membuka file di editor atau penampil Google yang relevan di browser. |
web |
Hanya output. Link untuk mendownload konten file di browser. Opsi ini hanya tersedia untuk file dengan konten biner di Google Drive. |
size |
Hanya output. Ukuran file blob dan editor pihak pertama dalam byte. Tidak akan diisi untuk file yang tidak memiliki ukuran, seperti pintasan dan folder. |
viewersCanCopyContent |
Tidak digunakan lagi: Gunakan |
permissions[] |
Hanya output. Daftar lengkap izin untuk file. Opsi ini hanya tersedia jika pengguna yang meminta dapat membagikan file. Tidak diisi untuk item di drive bersama. |
has |
Hanya output. Apakah file ini memiliki thumbnail. Hal ini tidak menunjukkan apakah aplikasi yang meminta memiliki akses ke thumbnail. Untuk memeriksa akses, cari keberadaan kolom thumbnailLink. |
spaces[] |
Hanya output. Daftar ruang yang berisi file. Nilai yang saat ini didukung adalah 'drive', 'appDataFolder', dan 'photos'. |
folder |
Warna untuk folder atau pintasan ke folder sebagai string heksadesimal RGB. Warna yang didukung dipublikasikan di kolom Jika warna yang tidak didukung ditentukan, warna terdekat dalam palet akan digunakan. |
id |
ID file. |
name |
Nama file. ID ini tidak harus unik dalam folder. Perhatikan bahwa untuk item yang tidak dapat diubah seperti folder tingkat atas drive bersama, folder root Drive Saya, dan folder Data Aplikasi, namanya bersifat konstan. |
description |
Deskripsi singkat file. |
starred |
Apakah pengguna telah memberi bintang pada file. |
trashed |
Apakah file telah dihapus, baik secara eksplisit maupun dari folder induk yang dihapus. Hanya pemilik yang dapat menghapus file ke sampah, dan pengguna lain tidak dapat melihat file di sampah pemilik. |
explicitly |
Hanya output. Apakah file telah dihapus secara eksplisit, bukan dihapus secara rekursif dari folder induk. |
created |
Waktu file dibuat (waktu tanggal RFC 3339). |
modified |
Terakhir kali file diubah oleh siapa pun (waktu tanggal RFC 3339). Perhatikan bahwa setelan |
modified |
Hanya output. Waktu terakhir file diubah oleh pengguna (waktu tanggal RFC 3339). |
viewed |
Terakhir kali file dilihat oleh pengguna (waktu tanggal RFC 3339). |
shared |
Hanya output. Waktu file dibagikan kepada pengguna, jika ada (waktu tanggal RFC 3339). |
quota |
Hanya output. Jumlah byte kuota penyimpanan yang digunakan oleh file. Hal ini mencakup revisi utama serta revisi sebelumnya dengan |
version |
Hanya output. Nomor versi yang meningkat secara monoton untuk file. Hal ini mencerminkan setiap perubahan yang dibuat pada file di server, bahkan perubahan yang tidak terlihat oleh pengguna. |
original |
Nama file asli konten yang diupload jika tersedia, atau nilai asli kolom |
owned |
Hanya output. Apakah pengguna memiliki file tersebut. Tidak diisi untuk item di drive bersama. |
full |
Hanya output. Ekstensi file lengkap yang diekstrak dari kolom Nilai ini diperbarui secara otomatis saat kolom |
properties |
Kumpulan key-value pair arbitrer yang terlihat oleh semua aplikasi. Entri dengan nilai null akan dihapus dalam permintaan pembaruan dan salinan. Objek yang berisi daftar pasangan |
app |
Kumpulan pasangan nilai kunci arbitrer yang bersifat pribadi untuk aplikasi yang meminta. Entri dengan nilai null akan dihapus dalam permintaan pembaruan dan salinan. Properti ini hanya dapat diambil menggunakan permintaan yang diautentikasi. Permintaan yang diautentikasi menggunakan token akses yang diperoleh dengan client ID OAuth 2. Anda tidak dapat menggunakan kunci API untuk mengambil properti pribadi. Objek yang berisi daftar pasangan |
is |
Hanya output. Apakah file dibuat atau dibuka oleh aplikasi yang meminta. |
teamDriveId |
Tidak digunakan lagi: Khusus output. Sebagai gantinya, gunakan |
capabilities |
Hanya output. Kemampuan yang dimiliki pengguna saat ini pada file ini. Setiap kemampuan sesuai dengan tindakan terperinci yang dapat dilakukan pengguna. |
capabilities.canChangeViewersCanCopyContent |
Tidak digunakan lagi: Khusus output. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat memindahkan turunan folder ini ke luar drive bersama. Nilai ini salah jika item bukan folder. Hanya diisi untuk item di drive bersama. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat membaca drive bersama tempat file ini berada. Hanya diisi untuk item di drive bersama. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat mengedit file ini. Faktor lain dapat membatasi jenis perubahan yang dapat dilakukan pengguna pada file. Misalnya, lihat |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat menyalin file ini. Untuk item di drive bersama, apakah pengguna saat ini dapat menyalin turunan non-folder dari item ini, atau item ini sendiri jika bukan folder. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat mengomentari file ini. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat menambahkan turunan ke folder ini. Ini selalu salah jika item bukan folder. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat menghapus file ini. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat mendownload file ini. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat mencantumkan turunan folder ini. Ini selalu salah jika item bukan folder. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat menghapus turunan dari folder ini. Ini selalu salah jika item bukan folder. Untuk folder di drive bersama, gunakan |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat mengganti nama file ini. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat memindahkan file ini ke sampah. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat membaca resource revisi file ini. Untuk item drive bersama, baik revisi turunan non-folder dari item ini, maupun item ini sendiri jika bukan folder, dapat dibaca. |
capabilities.canReadTeamDrive |
Tidak digunakan lagi: Khusus output. Sebagai gantinya, gunakan |
capabilities.canMoveTeamDriveItem |
Tidak digunakan lagi: Khusus output. Sebagai gantinya, gunakan |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat mengubah batasan |
capabilities.canMoveItemIntoTeamDrive |
Tidak digunakan lagi: Khusus output. Sebagai gantinya, gunakan |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat memulihkan file ini dari sampah. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat mengubah konten file ini. |
capabilities.canMoveItemWithinTeamDrive |
Tidak digunakan lagi: Khusus output. Sebagai gantinya, gunakan |
capabilities.canMoveItemOutOfTeamDrive |
Tidak digunakan lagi: Khusus output. Sebagai gantinya, gunakan |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat menghapus turunan folder ini. Nilai ini salah jika item bukan folder. Hanya diisi untuk item di drive bersama. |
capabilities.canMoveChildrenOutOfTeamDrive |
Tidak digunakan lagi: Khusus output. Sebagai gantinya, gunakan |
capabilities.canMoveChildrenWithinTeamDrive |
Tidak digunakan lagi: Khusus output. Sebagai gantinya, gunakan |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat membuang turunan folder ini. Nilai ini salah jika item bukan folder. Hanya diisi untuk item di drive bersama. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat memindahkan item ini ke luar drive ini dengan mengubah induknya. Perhatikan bahwa permintaan untuk mengubah induk item mungkin masih gagal, bergantung pada induk baru yang ditambahkan. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat menambahkan induk untuk item tanpa menghapus induk yang ada dalam permintaan yang sama. Tidak diisi untuk file drive bersama. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat menghapus induk dari item tanpa menambahkan induk lain dalam permintaan yang sama. Tidak diisi untuk file drive bersama. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat memindahkan item ini dalam drive ini. Perhatikan bahwa permintaan untuk mengubah induk item mungkin masih gagal, bergantung pada induk baru yang ditambahkan dan induk yang dihapus. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat mengubah setelan berbagi untuk file ini. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat memindahkan turunan folder ini dalam drive ini. Nilai ini salah jika item bukan folder. Perhatikan bahwa permintaan untuk memindahkan turunan mungkin masih gagal, bergantung pada akses pengguna saat ini ke turunan dan ke folder tujuan. |
capabilities.canModifyContentRestriction |
Tidak digunakan lagi: Khusus output. Gunakan salah satu dari |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat menambahkan folder dari drive lain (drive bersama yang berbeda atau Drive Saya) ke folder ini. Nilai ini salah jika item bukan folder. Hanya diisi untuk item di drive bersama. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat mengubah kolom securityUpdateEnabled di metadata berbagi link. |
capabilities. |
Hanya output. Apakah pengguna saat ini adalah pemilik file yang tertunda. Tidak diisi untuk file drive bersama. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat membaca label pada file. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat mengubah label pada file. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat menambahkan atau mengubah batasan konten pada file yang dibatasi editor. |
capabilities. |
Hanya output. Apakah pengguna saat ini dapat menambahkan atau mengubah batasan konten yang dibatasi pemilik. |
capabilities. |
Hanya output. Apakah ada batasan konten pada file yang dapat dihapus oleh pengguna saat ini. |
capabilities. |
Apakah pengguna dapat menonaktifkan izin yang diwarisi. |
capabilities. |
Apakah pengguna dapat mengaktifkan kembali izin yang diwarisi. |
has |
Hanya output. Apakah ada izin langsung di file ini. Kolom ini hanya diisi untuk item di drive bersama. |
trashing |
Hanya output. Jika file telah dihapus secara eksplisit, pengguna yang menghapusnya. Hanya diisi untuk item di drive bersama. |
thumbnail |
Hanya output. Versi thumbnail untuk digunakan dalam pembatalan validasi cache thumbnail. |
trashed |
Hanya output. Waktu item dihapus (waktu tanggal RFC 3339). Hanya diisi untuk item di drive bersama. |
modified |
Hanya output. Apakah file telah diubah oleh pengguna ini. |
permission |
Hanya output. files.list ID izin untuk pengguna yang memiliki akses ke file ini. |
image |
Hanya output. Metadata tambahan tentang media gambar, jika ada. |
image |
Hanya output. Apakah flash digunakan untuk membuat foto. |
image |
Hanya output. Mode pengukuran yang digunakan untuk membuat foto. |
image |
Hanya output. Jenis sensor yang digunakan untuk membuat foto. |
image |
Hanya output. Mode eksposur yang digunakan untuk membuat foto. |
image |
Hanya output. Ruang warna foto. |
image |
Hanya output. Mode white balance yang digunakan untuk membuat foto. |
image |
Hanya output. Lebar gambar dalam piksel. |
image |
Hanya output. Tinggi gambar dalam piksel. |
image |
Hanya output. Informasi lokasi geografis yang disimpan dalam gambar. |
image |
Hanya output. Lintang yang disimpan dalam gambar. |
image |
Hanya output. Bujur yang disimpan dalam gambar. |
image |
Hanya output. Ketinggian yang disimpan dalam gambar. |
image |
Hanya output. Jumlah rotasi 90 derajat searah jarum jam yang diterapkan dari orientasi asli gambar. |
image |
Hanya output. Tanggal dan waktu foto diambil (EXIF DateTime). |
image |
Hanya output. Merek kamera yang digunakan untuk membuat foto. |
image |
Hanya output. Model kamera yang digunakan untuk membuat foto. |
image |
Hanya output. Durasi eksposur, dalam detik. |
image |
Hanya output. Apertur yang digunakan untuk membuat foto (f-number). |
image |
Hanya output. Panjang fokus yang digunakan untuk membuat foto, dalam milimeter. |
image |
Hanya output. Kecepatan ISO yang digunakan untuk membuat foto. |
image |
Hanya output. Bias eksposur foto (nilai APEX). |
image |
Hanya output. F-number lensa terkecil pada panjang fokus yang digunakan untuk membuat foto (nilai APEX). |
image |
Hanya output. Jarak ke subjek foto, dalam meter. |
image |
Hanya output. Lensa yang digunakan untuk membuat foto. |
video |
Hanya output. Metadata tambahan tentang media video. Fitur ini mungkin tidak langsung tersedia setelah diupload. |
video |
Hanya output. Lebar video dalam piksel. |
video |
Hanya output. Tinggi video dalam piksel. |
video |
Hanya output. Durasi video dalam milidetik. |
shortcut |
Detail file pintasan. Hanya diisi untuk file pintasan, yang memiliki kolom mimeType yang ditetapkan ke |
shortcut |
ID file yang dituju oleh pintasan ini. Hanya dapat ditetapkan pada permintaan |
shortcut |
Hanya output. Jenis MIME file yang dituju oleh pintasan ini. Nilai kolom ini adalah snapshot jenis MIME target, yang diambil saat pintasan dibuat. |
shortcut |
Hanya output. ResourceKey untuk file target. |
content |
Batasan untuk mengakses konten file. Hanya diisi jika batasan tersebut ada. |
resource |
Hanya output. Kunci yang diperlukan untuk mengakses item melalui link bersama. |
link |
Hanya output. Detail terkait LinkShare. Berisi detail tentang URL link yang digunakan klien untuk merujuk ke item ini. |
link |
Hanya output. Apakah file memenuhi syarat untuk update keamanan. |
link |
Hanya output. Apakah update keamanan diaktifkan untuk file ini. |
label |
Hanya output. Ringkasan label pada file. |
label |
Hanya output. Kumpulan label pada file seperti yang diminta oleh ID label dalam parameter |
sha1 |
Hanya output. Checksum SHA1 yang terkait dengan file ini, jika tersedia. Kolom ini hanya diisi untuk file dengan konten yang disimpan di Google Drive; kolom ini tidak diisi untuk Editor Dokumen atau file pintasan. |
sha256 |
Hanya output. Checksum SHA256 yang terkait dengan file ini, jika tersedia. Kolom ini hanya diisi untuk file dengan konten yang disimpan di Google Drive; kolom ini tidak diisi untuk Editor Dokumen atau file pintasan. |
inherited |
Apakah izin yang diwariskan untuk file ini dinonaktifkan. Izin yang diwariskan diaktifkan secara default. |
ContentRestriction
Pembatasan untuk mengakses konten file.
Representasi JSON |
---|
{
"readOnly": boolean,
"reason": string,
"type": string,
"restrictingUser": {
object ( |
Kolom | |
---|---|
read |
Apakah konten file bersifat hanya baca. Jika file bersifat hanya baca, revisi baru file tersebut tidak dapat ditambahkan, komentar tidak dapat ditambahkan atau diubah, dan judul file tidak dapat diubah. |
reason |
Alasan konten file dibatasi. Ini hanya dapat diubah pada permintaan yang juga menetapkan |
type |
Hanya output. Jenis batasan konten. Saat ini, satu-satunya nilai yang dapat digunakan adalah |
restricting |
Hanya output. Pengguna yang menetapkan batasan konten. Hanya diisi jika |
restriction |
Hanya output. Waktu saat batasan konten ditetapkan (stempel waktu RFC 3339 yang diformat). Hanya diisi jika |
owner |
Apakah batasan konten hanya dapat diubah atau dihapus oleh pengguna yang memiliki file. Untuk file di drive bersama, pengguna mana pun dengan kemampuan |
system |
Hanya output. Apakah batasan konten diterapkan oleh sistem, misalnya karena tanda tangan elektronik. Pengguna tidak dapat mengubah atau menghapus batasan konten yang dibatasi sistem. |
Metode |
|
---|---|
|
Membuat salinan file dan menerapkan update yang diminta dengan semantik patch. |
|
Membuat file baru. |
|
Menghapus file milik pengguna secara permanen tanpa memindahkannya ke sampah. |
|
Mendownload konten file. |
|
Menghapus secara permanen semua file yang dihapus pengguna. |
|
Mengekspor dokumen Google Workspace ke jenis MIME yang diminta dan menampilkan konten byte yang diekspor. |
|
Menghasilkan kumpulan ID file yang dapat diberikan dalam permintaan pembuatan atau penyalinan. |
|
Mendapatkan metadata atau konten file berdasarkan ID. |
|
Mencantumkan file pengguna. |
|
Mencantumkan label pada file. |
|
Mengubah kumpulan label yang diterapkan ke file. |
|
Memperbarui metadata dan/atau konten file. |
|
Berlangganan perubahan pada file. |