Method: files.update

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

這個方法支援 /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 轉碼語法。

路徑參數

參數
fileId

string

檔案的 ID。

查詢參數

參數
addParents

string

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

boolean

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

boolean

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

string

在匯入圖片時，用於光學字元辨識處理的語言提示 (ISO 639-1 代碼)。
removeParents

string

列出要移除的父項 ID，並以半形逗號分隔。
supportsAllDrives

boolean

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

boolean

已淘汰：請改用 supportsAllDrives。
uploadType

string

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

可接受的值如下：

  • media - 簡易上傳。只上傳媒體，不含任何中繼資料。
  • multipart - 多部分上傳。在單一要求中上傳媒體和中繼資料。
  • resumable - 可續傳的上傳作業。以可續傳的方式上傳檔案，使用至少兩次要求，其中第一個要求包含中繼資料。
useContentAsIndexableText

boolean

是否將上傳的內容做為可索引的文字。
includePermissionsForView

string

指定要納入回應的其他檢視畫面權限。僅支援「已發布」。
includeLabels

string

以半形逗號分隔的標籤 ID 清單，用於納入回應的 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

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