Method: files.update

Memperbarui metadata dan/atau konten file. Saat memanggil metode ini, hanya isi 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:*/*

Catatan: Tentukan jenis MIME yang valid, bukan nilai */* literal. */* literal hanya digunakan untuk menunjukkan bahwa jenis MIME yang valid dapat diupload.

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

Permintaan HTTP

  • URI Upload, untuk permintaan upload media:
    PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId}
  • URI Metadata, untuk permintaan khusus metadata:
    PATCH https://www.googleapis.com/drive/v3/files/{fileId}

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
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 wajib. Selain itu, kolom ini tidak ditampilkan di widget "Coba metode ini" karena widget tersebut tidak mendukung upload data.

Nilai yang dapat diterima adalah:

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

string

ID file.

Parameter kueri

Parameter
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 wajib. Selain itu, kolom ini tidak ditampilkan di widget "Coba metode ini" karena widget tersebut tidak mendukung upload data.

Nilai yang dapat diterima adalah:

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

string

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

boolean

Tidak digunakan lagi: Menambahkan file ke beberapa folder tidak lagi didukung. Gunakan pintasan sebagai gantinya.
keepRevisionForever

boolean

Apakah akan menetapkan kolom 'keepForever' di revisi head baru. Ini hanya berlaku untuk file dengan konten biner di Google Drive. Hanya 200 revisi untuk file yang dapat disimpan selamanya. Jika batas ini tercapai, coba hapus revisi yang disematkan.
ocrLanguage

string

Petunjuk bahasa untuk pemrosesan OCR selama impor gambar (kode ISO 639-1).
removeParents

string

Daftar ID induk yang akan dipisahkan koma.
supportsAllDrives

boolean

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

boolean

Tidak digunakan lagi: Sebagai gantinya, gunakan supportsAllDrives.
useContentAsIndexableText

boolean

Apakah akan menggunakan konten yang diupload sebagai teks yang dapat diindeks.
includePermissionsForView

string

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

string

Daftar ID label yang dipisahkan koma untuk disertakan di 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/drive
  • https://www.googleapis.com/auth/drive.appdata
  • 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 membutuhkan penilaian keamanan agar aplikasi Anda dapat menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.