Resource: File
Metadata untuk file.
Beberapa metode resource (seperti files.update
) memerlukan fileId
. Gunakan metode files.list
untuk mengambil ID sebuah 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 |
driveId |
Hanya output. ID drive bersama tempat file berada. Hanya diisi untuk item di drive bersama. |
fileExtension |
Hanya output. Komponen akhir |
copyRequiresWriterPermission |
Apakah opsi untuk menyalin, mencetak, atau mendownload file ini harus dinonaktifkan bagi pembaca dan pengomentar. |
md5Checksum |
Hanya output. {i>checksum<i} MD5 untuk isi file. Ini hanya berlaku untuk file dengan konten biner di Google Drive. |
contentHints |
Informasi tambahan tentang konten file. Kolom ini tidak pernah diisi dalam respons. |
contentHints.indexableText |
Teks yang akan diindeks untuk file guna meningkatkan kueri fullText. Panjang file dibatasi hingga 128 KB dan dapat berisi elemen HTML. |
contentHints.thumbnail |
Thumbnail untuk file. Tindakan ini hanya akan digunakan jika Google Drive tidak dapat membuat thumbnail standar. |
contentHints.thumbnail.image |
Data thumbnail yang dienkode dengan Base64 yang aman untuk URL (RFC 4648 bagian 5). String berenkode base64. |
contentHints.thumbnail.mimeType |
Jenis MIME thumbnail. |
writersCanShare |
Apakah pengguna hanya dengan izin |
viewedByMe |
Hanya output. Apakah file telah dilihat oleh pengguna ini. |
mimeType |
Jenis MIME file. Google Drive akan otomatis mencoba mendeteksi nilai yang sesuai dari konten yang diupload, jika tidak ada nilai yang diberikan. Nilai tidak dapat diubah kecuali revisi baru diupload. Jika file dibuat dengan jenis MIME Google Doc, konten yang diupload akan diimpor, jika memungkinkan. Format impor yang didukung dipublikasikan di resource Tentang. |
exportLinks |
Hanya output. Link untuk mengekspor file Editor Dokumen ke format tertentu. Objek yang berisi daftar pasangan |
parents[] |
ID folder induk yang berisi file tersebut. 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 penyalinan, file ini mewarisi semua induk file sumber yang dapat ditemukan. Permintaan files.update harus menggunakan parameter |
thumbnailLink |
Hanya output. Link berumur singkat ke thumbnail file, jika tersedia. Biasanya berlangsung selama urutan jam. Hanya diisi saat aplikasi yang meminta dapat mengakses konten file. Jika file tidak dibagikan secara publik, URL yang ditampilkan di |
iconLink |
Hanya output. Link statis yang tidak diautentikasi ke ikon file. |
shared |
Hanya output. Apakah file telah dibagikan atau tidak. Tidak diisi untuk item di drive bersama. |
lastModifyingUser |
Hanya output. Pengguna terakhir yang mengubah file. |
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. |
headRevisionId |
Hanya output. ID revisi head file. Saat ini, tindakan ini hanya tersedia untuk file dengan konten biner di Google Drive. |
sharingUser |
Hanya output. Pengguna yang membagikan file kepada pengguna yang meminta, jika ada. |
webViewLink |
Hanya output. Link untuk membuka file di editor atau penampil Google yang relevan di browser. |
webContentLink |
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 dalam byte blob dan file editor pihak pertama. Tidak akan diisi untuk file yang tidak memiliki ukuran, seperti pintasan dan folder. |
viewersCanCopyContent |
Tidak digunakan lagi: Sebagai gantinya, gunakan |
permissions[] |
Hanya output. Daftar lengkap izin untuk file. Ini hanya tersedia jika pengguna yang meminta dapat membagikan file. Tidak diisi untuk item di drive bersama. |
hasThumbnail |
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'. |
folderColorRgb |
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. Hal ini tidak harus unik di 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 tidak berubah. |
description |
Deskripsi singkat file. |
starred |
Apakah pengguna telah memberi bintang pada file. |
trashed |
Apakah file telah dibuang ke sampah, baik secara eksplisit maupun dari folder induk yang telah dibuang. Hanya pemilik yang dapat memindahkan file ke sampah, dan pengguna lain tidak dapat melihat file di tong sampah pemiliknya. |
explicitlyTrashed |
Hanya output. Apakah file telah dibuang secara eksplisit, bukan dibuang secara berulang dari folder induk. |
createdTime |
Waktu pembuatan file (tanggal-waktu RFC 3339). |
modifiedTime |
Terakhir kali file diubah oleh siapa pun (tanggal-waktu RFC 3339). Perlu diketahui bahwa menyetel |
modifiedByMeTime |
Hanya output. Terakhir kali file diubah oleh pengguna (tanggal-waktu RFC 3339). |
viewedByMeTime |
Terakhir kali file dilihat oleh pengguna (tanggal-waktu RFC 3339). |
sharedWithMeTime |
Hanya output. Waktu saat file dibagikan kepada pengguna, jika berlaku (tanggal-waktu RFC 3339). |
quotaBytesUsed |
Hanya output. Jumlah byte kuota penyimpanan yang digunakan oleh file. Hal ini termasuk revisi utama serta revisi sebelumnya dengan |
version |
Hanya output. Nomor versi file yang meningkat secara monoton. Hal ini mencerminkan setiap perubahan yang dibuat pada file di server, bahkan perubahan yang tidak terlihat oleh pengguna. |
originalFilename |
Nama file asli dari konten yang diupload jika tersedia, atau nilai asli kolom |
ownedByMe |
Hanya output. Apakah pengguna adalah pemilik file. Tidak diisi untuk item di drive bersama. |
fullFileExtension |
Hanya output. Ekstensi file lengkap yang diekstrak dari kolom Kolom ini otomatis diperbarui saat kolom |
properties |
Kumpulan key-value pair arbitrer yang terlihat oleh semua aplikasi. Entri dengan nilai null akan dihapus dalam permintaan pembaruan dan penyalinan. Objek yang berisi daftar pasangan |
appProperties |
Kumpulan key-value pair arbitrer yang bersifat pribadi untuk aplikasi yang meminta. Entri dengan nilai null akan dihapus dalam permintaan pembaruan dan penyalinan. 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 |
isAppAuthorized |
Hanya output. Apakah file dibuat atau dibuka oleh aplikasi yang meminta. |
teamDriveId |
Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan |
capabilities |
Hanya output. Kemampuan yang dimiliki pengguna saat ini pada file ini. Setiap kemampuan berkaitan dengan tindakan terperinci yang dapat dilakukan pengguna. |
capabilities.canChangeViewersCanCopyContent |
Tidak digunakan lagi: Hanya output. |
capabilities.canMoveChildrenOutOfDrive |
Hanya output. Apakah pengguna saat ini dapat memindahkan turunan folder ini ke luar drive bersama. Nilai ini salah jika item bukan merupakan folder. Hanya diisi untuk item di drive bersama. |
capabilities.canReadDrive |
Hanya output. Apakah pengguna saat ini dapat membaca drive bersama tempat file ini berada. Hanya diisi untuk item di drive bersama. |
capabilities.canEdit |
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.canCopy |
Hanya output. Apakah pengguna saat ini dapat menyalin file ini. Untuk item di drive bersama, apakah pengguna saat ini dapat menyalin turunan non-folder item ini, atau item ini sendiri jika bukan folder. |
capabilities.canComment |
Hanya output. Apakah pengguna saat ini dapat mengomentari file ini. |
capabilities.canAddChildren |
Hanya output. Apakah pengguna saat ini dapat menambahkan turunan ke folder ini. Nilai ini selalu salah (false) jika item bukan merupakan folder. |
capabilities.canDelete |
Hanya output. Apakah pengguna saat ini dapat menghapus file ini. |
capabilities.canDownload |
Hanya output. Apakah pengguna saat ini dapat mendownload file ini. |
capabilities.canListChildren |
Hanya output. Apakah pengguna saat ini dapat mencantumkan turunan folder ini. Nilai ini selalu salah (false) jika item bukan merupakan folder. |
capabilities.canRemoveChildren |
Hanya output. Apakah pengguna saat ini dapat menghapus turunan dari folder ini. Nilai ini selalu salah (false) jika item bukan merupakan folder. Untuk folder dalam drive bersama, gunakan |
capabilities.canRename |
Hanya output. Apakah pengguna saat ini dapat mengganti nama file ini. |
capabilities.canTrash |
Hanya output. Apakah pengguna saat ini dapat memindahkan file ini ke sampah. |
capabilities.canReadRevisions |
Hanya output. Apakah pengguna saat ini dapat membaca resource revisi file ini. Untuk item drive bersama, baik revisi turunan non-folder item ini, atau item ini sendiri jika bukan folder, dapat dibaca. |
capabilities.canReadTeamDrive |
Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan |
capabilities.canMoveTeamDriveItem |
Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan |
capabilities.canChangeCopyRequiresWriterPermission |
Hanya output. Apakah pengguna saat ini dapat mengubah batasan |
capabilities.canMoveItemIntoTeamDrive |
Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan |
capabilities.canUntrash |
Hanya output. Apakah pengguna saat ini dapat memulihkan file ini dari sampah. |
capabilities.canModifyContent |
Hanya output. Apakah pengguna saat ini dapat mengubah konten file ini. |
capabilities.canMoveItemWithinTeamDrive |
Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan |
capabilities.canMoveItemOutOfTeamDrive |
Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan |
capabilities.canDeleteChildren |
Hanya output. Apakah pengguna saat ini dapat menghapus turunan folder ini. Nilai ini salah jika item bukan merupakan folder. Hanya diisi untuk item di drive bersama. |
capabilities.canMoveChildrenOutOfTeamDrive |
Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan |
capabilities.canMoveChildrenWithinTeamDrive |
Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan |
capabilities.canTrashChildren |
Hanya output. Apakah pengguna saat ini dapat memindahkan turunan dari folder ini atau tidak. Nilai ini salah jika item bukan merupakan folder. Hanya diisi untuk item di drive bersama. |
capabilities.canMoveItemOutOfDrive |
Hanya output. Apakah pengguna saat ini dapat memindahkan item ini ke luar drive ini dengan mengubah induknya. Perlu diperhatikan bahwa permintaan untuk mengubah induk item mungkin tetap gagal, bergantung pada induk baru yang ditambahkan. |
capabilities.canAddMyDriveParent |
Hanya output. Apakah pengguna saat ini dapat menambahkan induk untuk item tanpa menghapus induk yang sudah ada di permintaan yang sama. Tidak diisi untuk file drive bersama. |
capabilities.canRemoveMyDriveParent |
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.canMoveItemWithinDrive |
Hanya output. Apakah pengguna saat ini dapat memindahkan item ini dalam drive ini. Perlu diperhatikan bahwa permintaan untuk mengubah induk item mungkin tetap gagal, bergantung pada induk baru yang ditambahkan dan induk yang dihapus. |
capabilities.canShare |
Hanya output. Apakah pengguna saat ini dapat mengubah setelan berbagi untuk file ini. |
capabilities.canMoveChildrenWithinDrive |
Hanya output. Apakah pengguna saat ini dapat memindahkan turunan folder ini dalam drive ini. Nilai ini salah jika item bukan merupakan folder. Perlu diperhatikan 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: Hanya output. Gunakan salah satu dari |
capabilities.canAddFolderFromAnotherDrive |
Hanya output. Apakah pengguna saat ini dapat menambahkan folder dari drive lain (drive bersama atau Drive Saya yang berbeda) ke folder ini. Nilai ini salah jika item bukan merupakan folder. Hanya diisi untuk item di drive bersama. |
capabilities.canChangeSecurityUpdateEnabled |
Hanya output. Apakah pengguna saat ini dapat mengubah kolom securityUpdateEnabled pada metadata berbagi link. |
capabilities.canAcceptOwnership |
Hanya output. Apakah pengguna saat ini adalah pemilik file yang tertunda. Tidak diisi untuk file drive bersama. |
capabilities.canReadLabels |
Hanya output. Apakah pengguna saat ini dapat membaca label pada file. |
capabilities.canModifyLabels |
Hanya output. Apakah pengguna saat ini dapat mengubah label pada file. |
capabilities.canModifyEditorContentRestriction |
Hanya output. Apakah pengguna saat ini dapat menambahkan atau mengubah batasan konten pada file yang dibatasi editor. |
capabilities.canModifyOwnerContentRestriction |
Hanya output. Apakah pengguna saat ini dapat menambahkan atau mengubah batasan konten yang dibatasi pemilik. |
capabilities.canRemoveContentRestriction |
Hanya output. Apakah ada batasan konten pada file yang dapat dihapus oleh pengguna saat ini. |
hasAugmentedPermissions |
Hanya output. Apakah ada izin secara langsung pada file ini. Kolom ini hanya diisi untuk item di drive bersama. |
trashingUser |
Hanya output. Jika file telah dibuang secara eksplisit, berarti pengguna yang membuangnya. Hanya diisi untuk item di drive bersama. |
thumbnailVersion |
Hanya output. Versi thumbnail untuk digunakan dalam pembatalan cache thumbnail. |
trashedTime |
Hanya output. Waktu item dibuang (tanggal-waktu RFC 3339). Hanya diisi untuk item di drive bersama. |
modifiedByMe |
Hanya output. Apakah file telah diubah oleh pengguna ini. |
permissionIds[] |
Hanya output. files.list ID izin untuk pengguna yang memiliki akses ke file ini. |
imageMediaMetadata |
Hanya output. Metadata tambahan tentang media gambar, jika tersedia. |
imageMediaMetadata.flashUsed |
Hanya output. Apakah flash digunakan untuk membuat foto. |
imageMediaMetadata.meteringMode |
Hanya output. Mode pengukuran yang digunakan untuk membuat foto. |
imageMediaMetadata.sensor |
Hanya output. Jenis sensor yang digunakan untuk membuat foto. |
imageMediaMetadata.exposureMode |
Hanya output. Mode pencahayaan yang digunakan untuk membuat foto. |
imageMediaMetadata.colorSpace |
Hanya output. Ruang warna foto. |
imageMediaMetadata.whiteBalance |
Hanya output. Mode white balance yang digunakan untuk membuat foto. |
imageMediaMetadata.width |
Hanya output. Lebar gambar dalam piksel. |
imageMediaMetadata.height |
Hanya output. Tinggi gambar dalam piksel. |
imageMediaMetadata.location |
Hanya output. Informasi lokasi geografis yang disimpan dalam gambar. |
imageMediaMetadata.location.latitude |
Hanya output. Lintang yang disimpan dalam gambar. |
imageMediaMetadata.location.longitude |
Hanya output. Garis bujur yang disimpan dalam gambar. |
imageMediaMetadata.location.altitude |
Hanya output. Ketinggian yang disimpan dalam gambar. |
imageMediaMetadata.rotation |
Hanya output. Jumlah rotasi 90 derajat searah jarum jam yang diterapkan dari orientasi asli gambar. |
imageMediaMetadata.time |
Hanya output. Tanggal dan waktu foto diambil (EXIF DateTime). |
imageMediaMetadata.cameraMake |
Hanya output. Merek kamera yang digunakan untuk membuat foto. |
imageMediaMetadata.cameraModel |
Hanya output. Model kamera yang digunakan untuk membuat foto. |
imageMediaMetadata.exposureTime |
Hanya output. Durasi eksposur, dalam detik. |
imageMediaMetadata.aperture |
Hanya output. Bukaan yang digunakan untuk membuat foto (f-number). |
imageMediaMetadata.focalLength |
Hanya output. Panjang fokus yang digunakan untuk membuat foto, dalam milimeter. |
imageMediaMetadata.isoSpeed |
Hanya output. Kecepatan ISO yang digunakan untuk membuat foto. |
imageMediaMetadata.exposureBias |
Hanya output. Bias eksposur foto (nilai APEX). |
imageMediaMetadata.maxApertureValue |
Hanya output. F-number terkecil lensa pada panjang fokus yang digunakan untuk membuat foto (nilai APEX). |
imageMediaMetadata.subjectDistance |
Hanya output. Jarak ke subjek foto, dalam meter. |
imageMediaMetadata.lens |
Hanya output. Lensa yang digunakan untuk membuat foto. |
videoMediaMetadata |
Hanya output. Metadata tambahan tentang media video. Fitur ini mungkin tidak langsung tersedia setelah diupload. |
videoMediaMetadata.width |
Hanya output. Lebar video dalam piksel. |
videoMediaMetadata.height |
Hanya output. Tinggi video dalam piksel. |
videoMediaMetadata.durationMillis |
Hanya output. Durasi video dalam milidetik. |
shortcutDetails |
Detail file pintasan. Hanya diisi untuk file pintasan, yang memiliki kolom mimeType ditetapkan ke |
shortcutDetails.targetId |
ID file yang dituju pintasan ini. |
shortcutDetails.targetMimeType |
Hanya output. Jenis MIME file yang ditunjuk oleh pintasan ini. Nilai kolom ini adalah snapshot dari jenis MIME target, yang diambil saat pintasan dibuat. |
shortcutDetails.targetResourceKey |
Hanya output. ResourceKey untuk file target. |
contentRestrictions[] |
Batasan untuk mengakses konten file. Hanya diisi jika ada batasan tersebut. |
resourceKey |
Hanya output. Kunci yang diperlukan untuk mengakses item melalui link bersama. |
linkShareMetadata |
Hanya output. Detail terkait LinkShare. Berisi detail tentang URL link yang digunakan klien untuk merujuk ke item ini. |
linkShareMetadata.securityUpdateEligible |
Hanya output. Apakah file memenuhi syarat untuk update keamanan. |
linkShareMetadata.securityUpdateEnabled |
Hanya output. Apakah update keamanan diaktifkan untuk file ini. |
labelInfo |
Hanya output. Ringkasan label pada file. |
labelInfo.labels[] |
Hanya output. Kumpulan label pada file seperti yang diminta oleh ID label dalam parameter |
sha1Checksum |
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 tidak diisi untuk Editor Dokumen atau file pintasan. |
sha256Checksum |
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 tidak diisi untuk Editor Dokumen atau file pintasan. |
ContentRestriction
Batasan untuk mengakses konten file.
Representasi JSON |
---|
{
"readOnly": boolean,
"reason": string,
"type": string,
"restrictingUser": {
object ( |
Kolom | |
---|---|
readOnly |
Apakah konten file bersifat hanya baca. Jika file bersifat hanya-baca, revisi baru file tidak dapat ditambahkan, komentar tidak dapat ditambahkan atau diubah, dan judul file tidak dapat diubah. |
reason |
Alasan mengapa konten file dibatasi. Kolom ini hanya dapat diubah pada permintaan yang juga menetapkan |
type |
Hanya output. Jenis pembatasan konten. Saat ini, satu-satunya nilai yang memungkinkan adalah |
restrictingUser |
Hanya output. Pengguna yang menetapkan batasan konten. Hanya diisi jika |
restrictionTime |
Hanya output. Waktu saat pembatasan konten ditetapkan (stempel waktu RFC 3339 berformat). Hanya diisi jika |
ownerRestricted |
Apakah batasan konten hanya dapat diubah atau dihapus oleh pengguna yang memiliki file. Untuk file di drive bersama, setiap pengguna dengan kemampuan |
systemRestricted |
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 apa pun yang diminta dengan semantik patch. |
|
Membuat file baru. |
|
Menghapus file milik pengguna secara permanen tanpa memindahkannya ke sampah. |
|
Menghapus semua file pengguna yang dibuang ke sampah secara permanen. |
|
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. |
|
Memodifikasi kumpulan label yang diterapkan ke file. |
|
Memperbarui metadata dan/atau konten file. |
|
Berlangganan perubahan pada file. |