建立新檔案。
這個方法支援 /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 轉碼語法。
查詢參數
參數 | |
---|---|
uploadType |
可接受的值為: |
enforceSingleParent |
已淘汰,我們不再支援在多個資料夾中建立檔案, |
ignoreDefaultVisibility |
是否要忽略網域對於建立檔案的預設瀏覽權限設定。網域管理員可以選擇是否讓網域檢視所有上傳的檔案,而這個參數會讓要求略過該行為。權限仍沿用自上層資料夾。 |
keepRevisionForever |
是否要在新首修訂版本中設定「keepForever」欄位。這僅適用於 Google 雲端硬碟中含有二進位內容的檔案。只能永久保存檔案 200 個修訂版本。如果達到上限,請嘗試刪除固定的修訂版本。 |
ocrLanguage |
匯入圖片期間進行 OCR 處理的語言提示 (ISO 639-1 程式碼)。 |
supportsAllDrives |
提出要求的應用程式是否支援「我的雲端硬碟」和共用雲端硬碟。 |
supportsTeamDrives |
已淘汰:請改用 |
useContentAsIndexableText |
是否使用上傳內容做為可建立索引的文字。 |
includePermissionsForView |
指定要在回應中加入哪些額外檢視畫面權限。僅支援「已發布」。 |
includeLabels |
要包含在回應的 |
要求主體
要求主體包含 File
的例項。
回應主體
如果成功,回應主體會包含 File
的執行例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
部分範圍受到限制,應用程式必須進行安全性評估,才能使用這些範圍。詳情請參閱授權指南。