Method: files.patch

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 berubah secara otomatis, seperti diubahTanggal. Metode ini mendukung semantik patch.

Permintaan HTTP

PATCH https://www.googleapis.com/drive/v2/files/{fileId}

URL 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 yang akan 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 diupdate. Tindakan ini akan menggantikan setModifiedDate.

newRevision

boolean

Apakah upload blob harus membuat revisi baru. Jika salah, data blob di revisi head saat ini akan diganti. Jika kebijakan disetel ke benar (true) atau tidak disetel, blob baru akan dibuat sebagai revisi kepala (head revisi), dan revisi yang tidak disematkan sebelumnya akan dipertahankan untuk waktu yang singkat. Revisi yang disematkan disimpan tanpa batas, menggunakan kuota penyimpanan tambahan, hingga maksimum 200 revisi. Untuk mengetahui detail tentang cara revisi disimpan, lihat Pusat Bantuan Drive. Perlu diperhatikan bahwa kolom ini akan diabaikan jika tidak ada payload dalam permintaan.

ocr

boolean

Coba OCR pada upload .jpg, .png, .gif, atau .pdf.

ocrLanguage

string

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

pinned

boolean

Apakah akan menyematkan revisi baru. Sebuah file dapat memiliki maksimum 200 revisi yang disematkan. Perlu diperhatikan bahwa kolom ini akan diabaikan jika tidak ada payload dalam permintaan.

removeParents

string

Daftar ID induk yang akan dipisahkan koma.

setModifiedDate

boolean

Apakah untuk menetapkan tanggal yang diubah menggunakan nilai yang diberikan dalam isi permintaan. Menetapkan kolom ini ke true setara dengan modifiedDateBehavior=fromBodyOrNow, dan false setara dengan modifiedDateBehavior=now. Untuk mencegah perubahan apa pun pada tanggal yang diubah, tetapkan modifiedDateBehavior=noChange.

supportsAllDrives

boolean

Apakah aplikasi yang meminta mendukung Drive Saya dan drive bersama.

supportsTeamDrives
(deprecated)

boolean

Tidak digunakan lagi: Sebagai gantinya, gunakan supportsAllDrives.

timedTextLanguage

string

Bahasa teks dengan waktu.

timedTextTrackName

string

Nama trek teks dengan waktu.

updateViewedDate

boolean

Apakah akan memperbarui tanggal tampilan setelah berhasil memperbarui file.

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 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/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 membutuhkan penilaian keamanan agar aplikasi Anda dapat menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.