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 部分中的標籤 ID 清單 (以半形逗號分隔)。

要求主體

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

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