Method: files.update

更新檔案的中繼資料、內容或兩者。

呼叫這個方法時，請只填入要修改的欄位。更新欄位時，系統可能會自動變更部分欄位，例如 modifiedDate。這個方法支援 patch 語意。

這個方法支援 /upload URI，並接受具有下列特性的上傳媒體：

如要進一步瞭解如何上傳檔案，請參閱「上傳檔案資料」。

HTTP 要求

  • 上傳 URI，適用於媒體上傳要求：
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • 中繼資料 URI (僅限中繼資料要求)：
    PUT 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 檔案執行 OCR。
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

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

string

向 /upload URI 發出的上傳要求類型。如果您要使用 /upload URI 上傳資料，則必須填寫這個欄位。如果您要建立僅含中繼資料的檔案，則不必填寫這個欄位。此外，由於「試試這個方法」小工具不支援上傳資料，因此不會顯示這個欄位。

可接受的值如下：

  • media - 簡易上傳。只上傳媒體，不含任何中繼資料。
  • multipart - 多部分上傳作業。在單一要求中上傳媒體和中繼資料。
  • resumable - 支援續傳的上傳作業。使用一系列至少兩項要求，以續傳方式上傳檔案，其中第一項要求包含中繼資料。
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

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