Method: files.update

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

此方法支援 /upload URI，且接受上傳且具備下列特性的媒體：

  • 檔案大小上限：5,120 GB
  • 接受的媒體 MIME 類型：*/*

請注意：請指定有效的 MIME 類型，而非文字 */* 值。*/* 文字只是用來上傳任何有效的 MIME 類型。

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

HTTP 要求

  • 上傳 URI，用於媒體上傳要求：
    PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId}
  • 中繼資料 URI，僅限中繼資料要求：
    PATCH https://www.googleapis.com/drive/v3/files/{fileId}

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

路徑參數

參數
uploadType

string

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

可接受的值如下：

  • media - 簡易上傳只上傳不含中繼資料的媒體。
  • multipart - 多部分上傳作業。在單一要求中上傳媒體及其中繼資料。
  • resumable - 支援續傳的上傳作業。使用續傳功能上傳檔案，並使用至少兩項要求 (第一個要求內含中繼資料) 上傳檔案。
fileId

string

檔案的 ID。

查詢參數

參數
uploadType

string

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

可接受的值如下：

  • media - 簡易上傳只上傳不含中繼資料的媒體。
  • multipart - 多部分上傳作業。在單一要求中上傳媒體及其中繼資料。
  • resumable - 支援續傳的上傳作業。使用續傳功能上傳檔案，並使用至少兩項要求 (第一個要求內含中繼資料) 上傳檔案。
addParents

string

要新增的父項 ID 清單 (以半形逗號分隔)。
enforceSingleParent
(deprecated)

boolean

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

boolean

設定是否在新的車頭修訂版本中設定「keepForever」欄位。這項設定僅適用於 Google 雲端硬碟中含有二進位內容的檔案，只能保留檔案的 200 個修訂版本。如果已達上限，請嘗試刪除已固定的修訂版本。
ocrLanguage

string

圖片匯入期間的 OCR 處理語言提示 (ISO 639-1 代碼)。
removeParents

string

要移除的父項 ID 清單 (以半形逗號分隔)。
supportsAllDrives

boolean

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

boolean

已淘汰：請改用 supportsAllDrives。
useContentAsIndexableText

boolean

是否要使用上傳的內容做為可建立索引的文字。
includePermissionsForView

string

指定要在回應中包含哪些額外檢視畫面的權限。僅支援「已發布」。
includeLabels

string

以半形逗號分隔的清單，包含要在回應的 labelInfo 部分加入的標籤。

要求主體

要求主體包含 File 的例項。

回應主體

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

授權範圍

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

  • 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

部分範圍會受到限制，而且需要應用程式接受安全性評估才能使用這些範圍。詳情請參閱授權指南。