更新檔案的中繼資料和/或內容。呼叫此方法時，請只在您要修改的要求中填入欄位。更新欄位時，部分欄位可能會自動變更，例如 modifiedDate。這個方法可支援 patch 語意。
HTTP 要求
PATCH https://www.googleapis.com/drive/v2/files/{fileId}
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 | |
|---|---|
fileId |
要更新的檔案 ID。 |
查詢參數
| 參數 | |
|---|---|
addParents |
請以逗號分隔要新增的父項 ID 清單。 |
convert |
已淘汰：這個參數沒有任何功能。 |
enforceSingleParent |
已淘汰：系統不再支援將檔案新增至多個資料夾。請改用 |
modifiedDateBehavior |
決定更新 |
newRevision |
指出 Blob 上傳作業是否應建立新修訂版本。如果為 false，則會取代目前主版本中的 blob 資料。如果為 true 或未設定，系統會建立新的 Blob 做為最新修訂版本，並在短時間內保留先前未固定的修訂版本。已固定的修訂版本會無限期儲存，並使用額外的儲存空間配額，最多可儲存 200 個修訂版本。如要進一步瞭解如何保留修訂版本，請參閱 Google 雲端硬碟說明中心。請注意，如果要求中沒有酬載，系統會忽略這個欄位。 |
ocr |
是否嘗試對 .jpg、.png、.gif 或 .pdf 上傳檔案執行光學字元辨識。 |
ocrLanguage |
如果 ocr 為 true，則會提示要使用的語言。有效值為 BCP 47 代碼。 |
pinned |
是否要固定新修訂版本。檔案最多可有 200 個已固定修訂版本。請注意，如果要求中沒有酬載，系統會忽略這個欄位。 |
removeParents |
列出要移除的父項 ID，並以半形逗號分隔。 |
setModifiedDate |
是否要使用要求主體中提供的值來設定修改日期。將這個欄位設為 |
supportsAllDrives |
要求的應用程式是否同時支援「我的雲端硬碟」和共用雲端硬碟。 |
supportsTeamDrives |
已淘汰：請改用 |
timedTextLanguage |
時間軸文字的語言。 |
timedTextTrackName |
時間軸文字音軌名稱。 |
updateViewedDate |
成功更新檔案後是否要更新檢視日期。 |
useContentAsIndexableText |
是否將內容做為可索引的文字。 |
includePermissionsForView |
指定要納入回應的其他檢視畫面權限。系統僅支援 |
includeLabels |
以半形逗號分隔的標籤 ID 清單，用於納入回應的 |
要求主體
要求主體包含 File 的例項。
回應主體
如果成功，回應主體會包含 File 的執行例項。
授權範圍
需要下列其中一種 OAuth 範圍：
https://www.googleapis.com/auth/docshttps://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.appdatahttps://www.googleapis.com/auth/drive.apps.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.metadatahttps://www.googleapis.com/auth/drive.scripts
部分權限受限制，應用程式必須通過安全性評估才能使用。詳情請參閱授權指南。