Method: files.copy

建立檔案副本,並透過修補程式語意套用任何必要的更新。

HTTP 要求

POST https://www.googleapis.com/drive/v3/files/{fileId}/copy

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

路徑參數

參數
fileId

string

檔案的 ID。

查詢參數

參數
enforceSingleParent

boolean

已淘汰,不再支援將檔案複製到多個資料夾。請改用快速鍵。

ignoreDefaultVisibility

boolean

是否針對已建立的檔案忽略網域的預設瀏覽權限設定。網域管理員可以選擇讓所有上傳的檔案都公開顯示於網域,而這個參數會略過這項要求。權限仍沿用自上層資料夾。

keepRevisionForever

boolean

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

ocrLanguage

string

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

已淘汰:請改用 supportsAllDrives

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.photos.readonly

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