建立新檔案。
這個方法支援 /upload URI,並接受具有下列特性的上傳媒體:
- 檔案大小上限:5,120 GB
- 接受的媒體 MIME 類型:
*/*
注意:請指定有效的 MIME 類型,而非常值 */*
值。文字常值 */*
僅用於表示可上傳任何有效的 MIME 類型。
如要進一步瞭解如何上傳檔案,請參閱「上傳檔案資料」。
使用 files.create
建立捷徑的應用程式必須指定 MIME 類型 application/vnd.google-apps.shortcut
。
應用程式使用 API 插入檔案時,應在 name
屬性中指定副檔名。舉例來說,插入 JPEG 檔案的作業應在中繼資料中指定 "name": "cat.jpg"
之類的項目。
後續的 GET
要求會納入唯讀的 fileExtension
屬性,並使用 title
屬性中原先指定的擴充功能填入該屬性。當 Google 雲端硬碟使用者要求下載檔案,或是透過同步處理用戶端下載檔案時,雲端硬碟會根據檔名建立完整的檔案名稱 (含副檔名)。如果副檔名缺少,雲端硬碟會嘗試根據檔案的 MIME 類型判斷副檔名。
HTTP 要求
- 上傳 URI,適用於媒體上傳要求:
POST https://www.googleapis.com/upload/drive/v3/files
- 中繼資料 URI,適用於僅中繼資料要求:
POST https://www.googleapis.com/drive/v3/files
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 | |
---|---|
enforceSingleParent |
已淘汰,我們不再支援在多個資料夾中建立檔案。 |
ignoreDefaultVisibility |
是否忽略建立檔案時的網域預設顯示設定。網域管理員可以選擇讓所有上傳的檔案預設為對網域可見;這個參數會略過要求的這項行為。權限仍會繼承自父項資料夾。 |
keepRevisionForever |
是否要在新的主修訂版本中設定「keepForever」欄位。這項功能僅適用於 Google 雲端硬碟中含有二進位內容的檔案。檔案的修訂版本最多只能保留 200 個。如果已達上限,請嘗試刪除已固定的修訂版本。 |
ocrLanguage |
在匯入圖片時,用於光學字元辨識處理的語言提示 (ISO 639-1 代碼)。 |
supportsAllDrives |
要求的應用程式是否同時支援「我的雲端硬碟」和共用雲端硬碟。 |
supportsTeamDrives |
已淘汰:請改用 |
uploadType |
上傳要求的類型,用於 可接受的值如下: |
useContentAsIndexableText |
是否將上傳的內容做為可索引的文字。 |
includePermissionsForView |
指定要納入回應的其他檢視畫面權限。僅支援「已發布」。 |
includeLabels |
以半形逗號分隔的標籤 ID 清單,用於納入回應的 |
要求主體
要求主體包含 File
的例項。
回應主體
如果成功,回應主體會包含 File
的執行例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
部分權限受限制,應用程式必須通過安全性評估才能使用。詳情請參閱授權指南。