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 fullFileExtension. Opsi 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 pengomentar.

string

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

object

Informasi tambahan tentang konten file. Kolom ini tidak pernah diisi dalam respons.

string

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

object

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

string (bytes format)

Data thumbnail yang dienkode dengan Base64 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 belum.

string

Jenis MIME file.

Google Drive berupaya untuk 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 Dokumen Google, 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.

Sebuah file hanya dapat memiliki satu folder induk; menetapkan beberapa induk tidak didukung.

Jika tidak ditentukan sebagai bagian dari permintaan pembuatan, file akan ditempatkan langsung di folder Drive Saya pengguna. Jika tidak ditentukan sebagai bagian dari permintaan penyalinan, file akan mewarisi induk yang dapat ditemukan dari file sumber. Permintaan files.update harus menggunakan parameter addParents dan removeParents untuk mengubah daftar induk.

string

Hanya output. Link berumur singkat ke thumbnail file, jika tersedia. Biasanya berlangsung dalam urutan jam. Tidak ditujukan untuk penggunaan langsung di aplikasi web karena kebijakan Cross-Origin Resource Sharing (CORS), pertimbangkan untuk menggunakan server proxy. Hanya diisi saat aplikasi yang meminta dapat mengakses konten file. Jika file tidak dibagikan secara publik, URL yang ditampilkan di Files.thumbnailLink harus diambil menggunakan permintaan berkredensial.

string

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

boolean

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

object (User)

Hanya output. Pengguna terakhir yang mengubah file. Kolom ini hanya diisi saat perubahan terakhir dilakukan oleh pengguna yang login.

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 head 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 ada.

string

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

string

Hanya output. Link untuk mendownload konten file di browser. Opsi 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. Opsi 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 menunjukkan 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 saat ini didukung adalah 'drive', 'appDataFolder' dan 'foto'.

string

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

Jika menentukan warna yang tidak didukung, warna terdekat pada palet akan digunakan.

string

ID file.

string

Nama file. Ini belum tentu unik dalam sebuah folder. Perhatikan bahwa untuk item yang tidak dapat diubah seperti folder tingkat teratas pada drive bersama, folder root Drive Saya, dan folder Data Aplikasi, namanya konstan.

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 pemiliknya.

boolean

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

string

Waktu pembuatan file (tanggal-waktu RFC 3339).

string

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

Perhatikan bahwa menyetel modifiedTime juga akan memperbarui modifiedByMeTime untuk pengguna.

string

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

string

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

string

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

string (int64 format)

Hanya output. Jumlah byte kuota penyimpanan yang digunakan oleh file. Hal ini termasuk revisi head serta revisi sebelumnya dengan keepForever diaktifkan.

string (int64 format)

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.

string

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

boolean

Hanya output. Apakah pengguna adalah pemilik file tersebut atau tidak. Tidak diisi untuk item di drive bersama.

string

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

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

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

Kumpulan pasangan nilai kunci arbitrer yang terlihat oleh semua aplikasi.

Entri dengan nilai null akan 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 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 "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: Hanya output. Sebagai gantinya, gunakan driveId.

object

Hanya output. Kemampuan yang dimiliki pengguna saat ini pada file ini. Setiap kemampuan berhubungan dengan tindakan terperinci yang dapat diambil pengguna.

boolean

Tidak digunakan lagi: Hanya output.

boolean

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.

boolean

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

boolean

Hanya output. Apakah pengguna saat ini dapat mengedit file ini. Faktor lain 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 ini sendiri jika bukan folder.

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

Hanya output. Apakah pengguna saat ini dapat menghapus turunan dari folder ini. Nilai 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 ini ke sampah.

boolean

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

boolean

Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan canReadDrive.

boolean

Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan canMoveItemWithinDrive atau canMoveItemOutOfDrive.

boolean

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

boolean

Tidak digunakan lagi: Hanya output. 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: Hanya output. Sebagai gantinya, gunakan canMoveItemWithinDrive.

boolean

Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan canMoveItemOutOfDrive.

boolean

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.

boolean

Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan canMoveChildrenOutOfDrive.

boolean

Tidak digunakan lagi: Hanya output. Sebagai gantinya, gunakan canMoveChildrenWithinDrive.

boolean

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.

boolean

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.

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 ini dalam drive ini. Perhatikan bahwa permintaan untuk mengubah induk item mungkin masih gagal, bergantung pada induk baru yang ditambahkan dan induk yang 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. 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.

boolean

Tidak digunakan lagi: Hanya output. Gunakan salah satu dari canModifyEditorContentRestriction, canModifyOwnerContentRestriction, atau canRemoveContentRestriction.

boolean

Hanya output. Apakah pengguna saat ini dapat menambahkan folder dari drive lain (drive bersama lain atau Drive Saya) ke folder ini. Nilai ini salah jika item bukan folder. Hanya diisi untuk item di drive bersama.

boolean

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

boolean

Hanya output. Apakah pengguna saat ini merupakan 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 pemiliknya.

boolean

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

boolean

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

object (User)

Hanya output. Jika file telah secara eksplisit dibuang, 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 dibuang ke sampah (tanggal-waktu 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. Garis bujur yang disimpan dalam gambar.

number

Hanya output. Ketinggian yang disimpan di 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 kamera yang digunakan 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. Angka f terkecil dari 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 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. Hanya dapat ditetapkan pada permintaan files.create.

string

ID file yang dituju pintasan ini. Hanya dapat ditetapkan pada permintaan files.create.

string

Hanya output. Jenis MIME file yang dituju pintasan ini. Nilai kolom ini adalah snapshot dari 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 ada pembatasan tersebut.

string

Hanya output. Diperlukan kunci 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 atau tidak.

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; 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; tidak diisi untuk Editor Dokumen atau file pintasan.