Method: files.update

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

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

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

注意：請指定有效的 MIME 類型，而非常值 */* 值。*/* 常值僅用於表示任何有效的 MIME 類型皆可上傳。

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

HTTP 要求

  • 上傳 URI，適用於媒體上傳要求：
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • 中繼資料 URI，適用於僅限中繼資料的要求：
    PUT https://www.googleapis.com/drive/v2/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 清單 (以半形逗號分隔)。
convert
(deprecated)

boolean

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

boolean

已淘汰：無法再將檔案新增至多個資料夾。請改用 shortcuts。
modifiedDateBehavior

enum (ModifiedDateBehavior)

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

boolean

是否應建立新的修訂版本。如果為 false，則會取代目前主要修訂版本中的 blob 資料。如果設為 true 或不設定，系統會建立新的 blob 做為首修訂版本，而之前未固定的修訂版本將會保留一小段時間。固定修訂版本會無限期保留，使用額外儲存空間配額 (上限為 200 個修訂版本)。如要進一步瞭解修訂版本的保留方式，請造訪雲端硬碟說明中心。
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

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

boolean

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

string

指定要在回應中加入哪些額外檢視畫面權限。系統僅支援 published。
includeLabels

string

要包含在回應的 labelInfo 部分中的標籤 ID 清單 (以半形逗號分隔)。

要求主體

要求主體包含 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

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