Method: files.update

Memperbarui metadata, konten, atau keduanya.

Saat memanggil metode ini, isi hanya kolom dalam permintaan yang ingin Anda ubah. Saat memperbarui kolom, beberapa kolom mungkin diubah secara otomatis, seperti modifiedDate. Metode ini mendukung semantik patch.

Metode ini mendukung URI /upload dan menerima media yang diupload dengan karakteristik berikut:

  • Ukuran file maksimum: 5.120 GB
  • Jenis MIME Media yang diterima: */*

    (Tentukan jenis MIME yang valid, bukan nilai */* literal. Literal */* hanya digunakan untuk menunjukkan bahwa jenis MIME yang valid dapat diupload. Untuk mengetahui informasi selengkapnya, lihat Jenis MIME yang didukung Google Workspace dan Google Drive.)

Untuk mengetahui informasi selengkapnya tentang cara mengupload file, lihat Mengupload data file.

Permintaan HTTP

  • URI upload, untuk permintaan upload media:
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • URI metadata, khusus untuk permintaan metadata:
    PUT https://www.googleapis.com/drive/v2/files/{fileId}

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
fileId

string

ID file yang akan diperbarui.

Parameter kueri

Parameter
addParents

string

Daftar ID induk yang dipisahkan koma untuk ditambahkan.
convert
(deprecated)

boolean

Tidak digunakan lagi: Parameter ini tidak memiliki fungsi.
enforceSingleParent
(deprecated)

boolean

Tidak digunakan lagi: Menambahkan file ke beberapa folder tidak lagi didukung. Sebagai gantinya, gunakan shortcuts.
modifiedDateBehavior

enum (ModifiedDateBehavior)

Menentukan perilaku saat modifiedDate diperbarui. Kolom ini menggantikan setModifiedDate.
newRevision

boolean

Apakah upload blob harus membuat revisi baru. Jika salah (false), data blob dalam revisi head saat ini akan diganti. Jika benar (true) atau tidak disetel, blob baru akan dibuat sebagai revisi head, dan revisi sebelumnya yang tidak disematkan akan dipertahankan untuk jangka waktu singkat. Revisi yang disematkan disimpan tanpa batas waktu, menggunakan kuota penyimpanan tambahan, hingga maksimum 200 revisi. Untuk mengetahui detail tentang cara revisi dipertahankan, lihat Pusat Bantuan Drive.
ocr

boolean

Apakah akan mencoba OCR pada upload .jpg, .png, .gif, atau .pdf.
ocrLanguage

string

Jika ocr benar, petunjuk bahasa yang akan digunakan. Nilai yang valid adalah kode BCP 47.
pinned

boolean

Apakah akan menyematkan revisi baru. File dapat memiliki maksimum 200 revisi yang disematkan.
removeParents

string

Daftar ID induk yang dipisahkan koma untuk dihapus.
setModifiedDate

boolean

Apakah akan menetapkan tanggal yang diubah menggunakan nilai yang diberikan dalam isi permintaan. Menetapkan kolom ini ke true sama dengan modifiedDateBehavior=fromBodyOrNow, dan false sama dengan modifiedDateBehavior=now. Untuk mencegah perubahan pada tanggal diubah yang ditetapkan modifiedDateBehavior=noChange.
supportsAllDrives

boolean

Apakah aplikasi yang meminta mendukung Drive Saya dan drive bersama.
supportsTeamDrives
(deprecated)

boolean

Tidak digunakan lagi: Gunakan supportsAllDrives sebagai gantinya.
timedTextLanguage

string

Bahasa teks yang disinkronkan dengan waktu.
timedTextTrackName

string

Nama trek teks yang disinkronkan dengan waktu.
updateViewedDate

boolean

Apakah akan memperbarui tanggal tampilan setelah berhasil memperbarui file.
uploadType

string

Jenis permintaan upload ke URI /upload. Jika Anda mengupload data dengan URI /upload, kolom ini wajib diisi. Jika Anda membuat file khusus metadata, kolom ini tidak diperlukan. Selain itu, kolom ini tidak ditampilkan di widget "Coba metode ini" karena widget tidak mendukung upload data.

Nilai yang dapat diterima adalah:

  • media - Upload sederhana. Upload media saja, tanpa metadata apa pun.
  • multipart - Upload multibagian. Upload media dan metadatanya, dalam satu permintaan.
  • resumable - Upload yang dapat dilanjutkan. Upload file dengan cara yang dapat dilanjutkan, menggunakan serangkaian minimal dua permintaan dengan permintaan pertama menyertakan metadata.
useContentAsIndexableText

boolean

Apakah akan menggunakan konten sebagai teks yang dapat diindeks.
includePermissionsForView

string

Menentukan izin tampilan tambahan mana yang akan disertakan dalam respons. Hanya published yang didukung.
includeLabels

string

Daftar ID label yang dipisahkan koma untuk disertakan dalam bagian labelInfo respons.

Isi permintaan

Isi permintaan memuat instance File.

Isi respons

Jika berhasil, isi respons memuat instance File.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

Beberapa cakupan dibatasi dan memerlukan penilaian keamanan agar aplikasi Anda dapat menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.