Method: files.patch

更新檔案的中繼資料和/或內容。呼叫此方法時，請只在您要修改的要求中填入欄位。更新欄位時，部分欄位可能會自動變更，例如 modifiedDate。這個方法可支援 patch 語意。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
fileId

string

要更新的檔案 ID。

查詢參數

參數
addParents

string

請以逗號分隔要新增的父項 ID 清單。
convert
(deprecated)

boolean

已淘汰：這個參數沒有任何功能。
enforceSingleParent
(deprecated)

boolean

已淘汰：系統不再支援將檔案新增至多個資料夾。請改用 shortcuts。
modifiedDateBehavior

enum (ModifiedDateBehavior)

決定更新 modifiedDate 的行為。這會覆寫 setModifiedDate。
newRevision

boolean

指出 Blob 上傳作業是否應建立新修訂版本。如果為 false，則會取代目前主版本中的 blob 資料。如果為 true 或未設定，系統會建立新的 Blob 做為最新修訂版本，並在短時間內保留先前未固定的修訂版本。已固定的修訂版本會無限期儲存，並使用額外的儲存空間配額，最多可儲存 200 個修訂版本。如要進一步瞭解如何保留修訂版本，請參閱 Google 雲端硬碟說明中心。請注意，如果要求中沒有酬載，系統會忽略這個欄位。
ocr

boolean

是否嘗試對 .jpg、.png、.gif 或 .pdf 上傳檔案執行光學字元辨識。
ocrLanguage

string

如果 ocr 為 true，則會提示要使用的語言。有效值為 BCP 47 代碼。
pinned

boolean

是否要固定新修訂版本。檔案最多可有 200 個已固定修訂版本。請注意，如果要求中沒有酬載，系統會忽略這個欄位。
removeParents

string

列出要移除的父項 ID，並以半形逗號分隔。
setModifiedDate

boolean

是否要使用要求主體中提供的值來設定修改日期。將這個欄位設為 true 相當於 modifiedDateBehavior=fromBodyOrNow，而 false 則相當於 modifiedDateBehavior=now。避免修改日期集 modifiedDateBehavior=noChange 的任何變更。
supportsAllDrives

boolean

要求的應用程式是否同時支援「我的雲端硬碟」和共用雲端硬碟。
supportsTeamDrives
(deprecated)

boolean

已淘汰：請改用 supportsAllDrives。
timedTextLanguage

string

時間軸文字的語言。
timedTextTrackName

string

時間軸文字音軌名稱。
updateViewedDate

boolean

成功更新檔案後是否要更新檢視日期。
useContentAsIndexableText

boolean

是否將內容做為可索引的文字。
includePermissionsForView

string

指定要納入回應的其他檢視畫面權限。系統僅支援 published。
includeLabels

string

以半形逗號分隔的標籤 ID 清單，用於納入回應的 labelInfo 部分。

要求主體

要求主體包含 File 的例項。

回應主體

如果成功，回應主體會包含 File 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍：

  • 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

部分權限受限制，應用程式必須通過安全性評估才能使用。詳情請參閱授權指南。