REST Resource: files

{
  "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 (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "name": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "createdTime": string,
  "modifiedTime": string,
  "modifiedByMeTime": string,
  "viewedByMeTime": string,
  "sharedWithMeTime": string,
  "quotaBytesUsed": string,
  "version": string,
  "originalFilename": string,
  "ownedByMe": boolean,
  "fullFileExtension": string,
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeViewersCanCopyContent": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "permissionIds": [
    string
  ],
  "imageMediaMetadata": {
    "flashUsed": boolean,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "width": integer,
    "height": integer,
    "location": {
      "latitude": number,
      "longitude": number,
      "altitude": number
    },
    "rotation": integer,
    "time": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": number,
    "aperture": number,
    "focalLength": number,
    "isoSpeed": integer,
    "exposureBias": number,
    "maxApertureValue": number,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string
}

string

Hanya output. Mengidentifikasi jenis resource ini. Nilai: string tetap "drive#file".

string

Hanya output. ID drive bersama tempat file berada. Hanya diisi untuk item di drive bersama.

string

Hanya output. Komponen akhir dari fullFileExtension. File ini hanya tersedia untuk file dengan konten biner di Google Drive.

boolean

Apakah opsi untuk menyalin, mencetak, atau mendownload file ini harus dinonaktifkan bagi pembaca dan pemberi komentar.

string

Hanya output. Checksum MD5 untuk konten file. Ini hanya berlaku untuk file dengan konten biner di Google Drive.

object

Informasi tambahan tentang isi file. Kolom ini tidak pernah diisi sebagai respons.

string

Teks yang akan diindeks untuk file guna meningkatkan kueri fullText. File ini dibatasi hingga 128 KB dan dapat berisi elemen HTML.

object

Thumbnail untuk file. Ini hanya akan digunakan jika Google Drive tidak dapat membuat thumbnail standar.

string (bytes format)

Data thumbnail yang dienkode dengan Base64 yang aman untuk URL (RFC 4648 bagian 5).

String berenkode base64.

string

Jenis MIME thumbnail.

boolean

Apakah pengguna dengan izin writer saja dapat mengubah izin file. Tidak diisi untuk item di drive bersama.

boolean

Hanya output. Apakah file telah dilihat oleh pengguna ini atau tidak.

string

Jenis MIME file.

Google Drive berupaya untuk secara otomatis 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 Dokumen, konten yang diupload akan diimpor, jika memungkinkan. Format impor yang didukung dipublikasikan di resource Tentang.

map (key: string, value: string)

Hanya output. Link untuk mengekspor file Editor Dokumen ke format tertentu.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

string

ID folder induk yang berisi file.

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 akan mewarisi semua induk file yang dapat ditemukan. Permintaan files.update harus menggunakan parameter addParents dan removeParents untuk mengubah daftar induk.

string

Hanya output. Link berumur pendek ke thumbnail file, jika tersedia. Biasanya berlangsung sesuai urutan jam buka. Hanya diisi saat aplikasi yang meminta dapat mengakses konten file. Jika file tidak dibagikan secara publik, URL yang ditampilkan dalam Files.thumbnailLink harus diambil menggunakan permintaan kredensial.

string

Hanya output. Link statis yang tidak diautentikasi ke ikon file.

boolean

Hanya output. Apakah file telah dibagikan. Tidak diisi untuk item di drive bersama.

object (User)

Hanya output. Pengguna terakhir yang mengubah file.

object (User)

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.

string

Hanya output. ID revisi kepala file. Saat ini, fitur ini hanya tersedia untuk file dengan konten biner di Google Drive.

object (User)

Hanya output. Pengguna yang membagikan file dengan pengguna yang meminta, jika berlaku.

string

Hanya output. Link untuk membuka file di editor atau penampil Google yang relevan di browser.

string

Hanya output. Link untuk mendownload konten file di browser. File ini hanya tersedia untuk file dengan konten biner di Google Drive.

string (int64 format)

Hanya output. Ukuran dalam byte blob dan file editor pihak pertama. Tidak akan diisi untuk file yang tidak memiliki ukuran, seperti pintasan dan folder.

boolean

Tidak digunakan lagi: Sebagai gantinya, gunakan copyRequiresWriterPermission.

object (Permission)

Hanya output. Daftar lengkap izin untuk file tersebut. Setelan ini hanya tersedia jika pengguna yang meminta dapat membagikan file. Tidak diisi untuk item di drive bersama.

boolean

Hanya output. Apakah file ini memiliki thumbnail. Ini tidak mengindikasikan apakah aplikasi yang meminta memiliki akses ke thumbnail. Untuk memeriksa akses, cari keberadaan kolom thumbnailLink.

string

Hanya output. Daftar ruang yang berisi file. Nilai yang didukung saat ini adalah 'drive', 'appDataFolder', dan 'photos'.

string

Warna untuk folder atau pintasan ke folder sebagai string heksadesimal RGB. Warna yang didukung dipublikasikan di kolom folderColorPalette pada resource Tentang.

Jika warna yang tidak didukung ditentukan, warna terdekat dalam palet akan digunakan.

string

ID file.

string

Nama file. Hal ini tidak harus unik dalam folder. Perhatikan bahwa untuk item yang tidak dapat diubah seperti folder tingkat teratas di drive bersama, folder root Drive Saya, dan folder Data Aplikasi bernama tetap.

string

Deskripsi singkat file.

boolean

Apakah pengguna telah memberi bintang pada file.

boolean

Apakah file telah dibuang, baik secara eksplisit maupun dari folder induk yang telah dibuang. Hanya pemilik yang dapat membuang file, dan pengguna lain tidak dapat melihat file di sampah pemilik.

boolean

Hanya output. Apakah file telah dibuang secara eksplisit, bukan secara rekursif dibuang dari folder induk.

string

Waktu saat file dibuat (waktu tanggal RFC 3339).

string

Terakhir kali file diubah oleh siapa pun (waktu tanggal RFC 3339).

Perhatikan bahwa menyetel modifiedTime juga akan memperbarui modifiedByMeTime untuk pengguna.

string

Hanya output. Terakhir kali file diubah oleh pengguna (waktu tanggal RFC 3339).

string

Terakhir kali file dilihat oleh pengguna (waktu tanggal RFC 3339).

string

Hanya output. Waktu saat file dibagikan kepada pengguna, jika berlaku (waktu tanggal RFC 3339).

string (int64 format)

Hanya output. Jumlah byte kuota penyimpanan yang digunakan oleh file. Ini termasuk revisi kepala serta revisi sebelumnya dengan keepForever diaktifkan.

string (int64 format)

Hanya output. Nomor versi yang meningkat secara monoton untuk file. Tindakan ini mencerminkan setiap perubahan yang dibuat pada file di server, bahkan perubahan yang tidak terlihat oleh pengguna.

string

Nama file asli dari konten yang diupload jika tersedia, atau nilai asli kolom name. File ini hanya tersedia untuk file dengan konten biner di Google Drive.

boolean

Hanya output. Apakah pengguna memiliki file. Tidak diisi untuk item di drive bersama.

string

Hanya output. Ekstensi file lengkap yang diekstrak dari kolom name. Dapat berisi beberapa ekstensi yang digabungkan, seperti "tar.gz". File ini hanya tersedia untuk file dengan konten biner di Google Drive.

Kolom ini otomatis diperbarui saat kolom name berubah, tetapi tidak akan dihapus jika nama baru tidak berisi ekstensi yang valid.

map (key: string, value: value (Value format))

Kumpulan pasangan nilai kunci arbitrer yang dapat dilihat oleh semua aplikasi.

Entri dengan nilai null dihapus dalam permintaan pembaruan dan penyalinan.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

map (key: string, value: value (Value format))

Kumpulan pasangan nilai kunci arbitrer yang bersifat pribadi untuk aplikasi yang meminta.

Entri dengan nilai null dihapus dalam permintaan pembaruan dan penyalinan.

Properti ini hanya dapat diambil menggunakan permintaan yang diautentikasi. Permintaan terautentikasi 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 "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

boolean

Hanya output. Apakah file dibuat atau dibuka oleh aplikasi yang meminta.

string

Tidak digunakan lagi: Output saja. Sebagai gantinya, gunakan driveId.

object

Hanya output. Kemampuan yang dimiliki pengguna saat ini pada file ini. Setiap kemampuan berkaitan dengan tindakan terperinci yang mungkin dilakukan pengguna.

boolean

Tidak digunakan lagi: Output saja.

boolean

Hanya output. Apakah pengguna saat ini dapat memindahkan turunan folder ini di luar drive bersama. Ini tidak berlaku jika item bukan folder. Hanya diisi untuk item di drive bersama.

boolean

Hanya output. Apakah pengguna saat ini dapat membaca drive bersama tempat file ini berada. Hanya diisi untuk item di drive bersama.

boolean

Hanya output. Apakah pengguna saat ini dapat mengedit file ini. Faktor lainnya dapat membatasi jenis perubahan yang dapat dilakukan pengguna pada file. Misalnya, lihat canChangeCopyRequiresWriterPermission atau canModifyContent.

boolean

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 itu sendiri jika bukan folder.

boolean

Hanya output. Apakah pengguna saat ini dapat mengomentari file ini.

boolean

Hanya output. Apakah pengguna saat ini dapat menambahkan anak ke folder ini. Ini selalu salah jika item bukan folder.

boolean

Hanya output. Apakah pengguna saat ini dapat menghapus file.

boolean

Hanya output. Apakah pengguna saat ini dapat mendownload file ini.

boolean

Hanya output. Apakah pengguna saat ini dapat mencantumkan turunan folder ini. Ini selalu salah jika item bukan folder.

boolean

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 canDeleteChildren atau canTrashChildren.

boolean

Hanya output. Apakah pengguna saat ini dapat mengganti nama file ini.

boolean

Hanya output. Apakah pengguna saat ini dapat memindahkan file ke sampah.

boolean

Hanya output. Apakah pengguna saat ini dapat membaca resource revisi untuk file ini. Untuk item drive bersama, revisi dari non-folder turunan item ini, atau item ini sendiri jika bukan folder, dapat dibaca.

boolean

Tidak digunakan lagi: Output saja. Sebagai gantinya, gunakan canReadDrive.

boolean

Tidak digunakan lagi: Output saja. Sebagai gantinya, gunakan canMoveItemWithinDrive atau canMoveItemOutOfDrive.

boolean

Hanya output. Apakah pengguna saat ini dapat mengubah batasan copyRequiresWriterPermission file ini.

boolean

Tidak digunakan lagi: Output saja. Sebagai gantinya, gunakan canMoveItemOutOfDrive.

boolean

Hanya output. Apakah pengguna saat ini dapat memulihkan file ini dari sampah.

boolean

Hanya output. Apakah pengguna saat ini dapat mengubah konten file ini.

boolean

Tidak digunakan lagi: Output saja. Sebagai gantinya, gunakan canMoveItemWithinDrive.

boolean

Tidak digunakan lagi: Output saja. Sebagai gantinya, gunakan canMoveItemOutOfDrive.

boolean

Hanya output. Apakah pengguna saat ini dapat menghapus turunan folder ini. Ini tidak berlaku jika item bukan folder. Hanya diisi untuk item di drive bersama.

boolean

Tidak digunakan lagi: Output saja. Sebagai gantinya, gunakan canMoveChildrenOutOfDrive.

boolean

Tidak digunakan lagi: Output saja. Sebagai gantinya, gunakan canMoveChildrenWithinDrive.

boolean

Hanya output. Apakah pengguna saat ini dapat memindahkan folder turunan ke folder sampah. Ini tidak berlaku jika item bukan folder. Hanya diisi untuk item di drive bersama.

boolean

Hanya output. Apakah pengguna saat ini dapat memindahkan item ini ke luar drive dengan mengubah induknya. Perlu diperhatikan bahwa permintaan untuk mengubah induk item mungkin masih gagal, bergantung pada induk baru yang ditambahkan.

boolean

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.

boolean

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.

boolean

Hanya output. Apakah pengguna saat ini dapat memindahkan item dalam drive ini. Permintaan untuk mengubah induk item mungkin masih gagal, bergantung pada induk baru yang ditambahkan dan induk yang sedang dihapus.

boolean

Hanya output. Apakah pengguna saat ini dapat mengubah setelan berbagi untuk file ini.

boolean

Hanya output. Apakah pengguna saat ini dapat memindahkan turunan folder ini dalam drive ini. Ini tidak berlaku jika item bukan folder. Perhatikan bahwa permintaan untuk memindahkan turunan mungkin masih gagal, tergantung pada akses pengguna saat ini ke turunan dan ke folder tujuan.

boolean

Tidak digunakan lagi: Output saja. Gunakan salah satu canModifyEditorContentRestriction, canModifyOwnerContentRestriction, atau canRemoveContentRestriction.

boolean

Hanya output. Apakah pengguna saat ini dapat menambahkan folder dari drive lain (drive bersama yang berbeda atau Drive Saya) ke folder ini. Ini tidak berlaku jika item bukan folder. Hanya diisi untuk item di drive bersama.

boolean

Hanya output. Apakah pengguna saat ini dapat mengubah kolom securityUpdateEnabled pada metadata berbagi link.

boolean

Hanya output. Apakah pengguna saat ini adalah pemilik file yang tertunda. Tidak diisi untuk file drive bersama.

boolean

Hanya output. Apakah pengguna saat ini dapat membaca label pada file.

boolean

Hanya output. Apakah pengguna saat ini dapat mengubah label pada file.

boolean

Hanya output. Apakah pengguna saat ini dapat menambahkan atau mengubah batasan konten pada file yang dibatasi editor.

boolean

Hanya output. Apakah pengguna saat ini dapat menambahkan atau mengubah batasan konten yang dibatasi pemilik.

boolean

Hanya output. Apakah ada batasan konten pada file yang dapat dihapus oleh pengguna saat ini.

boolean

Hanya output. Apakah ada izin langsung pada file ini atau tidak. Kolom ini hanya diisi untuk item di drive bersama.

object (User)

Hanya output. Jika file telah dibuang secara eksplisit, pengguna yang membuangnya. Hanya diisi untuk item di drive bersama.

string (int64 format)

Hanya output. Versi thumbnail untuk digunakan dalam pembatalan cache thumbnail.

string

Hanya output. Waktu item dihapus (waktu tanggal RFC 3339). Hanya diisi untuk item di drive bersama.

boolean

Hanya output. Apakah file telah diubah oleh pengguna ini.

string

Hanya output. files.list ID izin untuk pengguna yang memiliki akses ke file ini.

object

Hanya output. Metadata tambahan tentang media gambar, jika tersedia.

boolean

Hanya output. Apakah flash digunakan untuk membuat foto.

string

Hanya output. Mode pengukuran yang digunakan untuk membuat foto.

string

Hanya output. Jenis sensor yang digunakan untuk membuat foto.

string

Hanya output. Mode eksposur yang digunakan untuk membuat foto.

string

Hanya output. Ruang warna foto.

string

Hanya output. Mode white balance yang digunakan untuk membuat foto.

integer

Hanya output. Lebar gambar dalam piksel.

integer

Hanya output. Tinggi gambar dalam piksel.

object

Hanya output. Informasi lokasi geografis yang disimpan dalam gambar.

number

Hanya output. Lintang yang disimpan dalam gambar.

number

Hanya output. Bujur yang disimpan di gambar.

number

Hanya output. Ketinggian yang disimpan dalam gambar.

integer

Hanya output. Jumlah rotasi 90 derajat searah jarum jam yang diterapkan dari orientasi asli gambar.

string

Hanya output. Tanggal dan waktu foto diambil (EXIF DateTime).

string

Hanya output. Merek yang digunakan kamera untuk membuat foto.

string

Hanya output. Model kamera yang digunakan untuk membuat foto.

number

Hanya output. Durasi eksposur, dalam detik.

number

Hanya output. Bukaan yang digunakan untuk membuat foto (f-number).

number

Hanya output. Panjang fokus yang digunakan untuk membuat foto, dalam milimeter.

integer

Hanya output. Kecepatan ISO yang digunakan untuk membuat foto.

number

Hanya output. Bias eksposur foto (nilai APEX).

number

Hanya output. F-angka terkecil lensa pada panjang fokus yang digunakan untuk membuat foto (nilai APEX).

integer

Hanya output. Jarak ke subjek foto, dalam meter.

string

Hanya output. Lensa yang digunakan untuk membuat foto.

object

Hanya output. Metadata tambahan tentang media video. Opsi ini mungkin tidak langsung tersedia setelah video diupload.

integer

Hanya output. Lebar video dalam piksel.

integer

Hanya output. Tinggi video dalam piksel.

string (int64 format)

Hanya output. Durasi video dalam milidetik.

object

Detail file pintasan. Hanya diisi untuk file pintasan, dengan kolom mimeType yang ditetapkan ke application/vnd.google-apps.shortcut.

string

ID file yang menjadi tujuan pintasan ini.

string

Hanya output. Jenis file MIME yang ditunjuk oleh pintasan ini. Nilai kolom ini adalah snapshot jenis MIME target, yang diambil saat pintasan dibuat.

string

Hanya output. ResourceKey untuk file target.

object (ContentRestriction)

Pembatasan untuk mengakses konten file. Hanya diisi jika batasan tersebut ada.

string

Hanya output. Kunci yang diperlukan untuk mengakses item melalui link bersama.

object

Hanya output. Detail terkait LinkShare. Berisi detail tentang URL link yang digunakan klien untuk merujuk ke item ini.

boolean

Hanya output. Apakah file memenuhi syarat untuk update keamanan.

boolean

Hanya output. Apakah update keamanan diaktifkan untuk file ini.

object

Hanya output. Ringkasan label pada file.

object (Label)

Hanya output. Kumpulan label pada file seperti yang diminta oleh ID label dalam parameter includeLabels. Secara default, tidak ada label yang ditampilkan.

string

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.

string

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.