Method: files.create

建立新檔案。

這個方法支援 /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

string

/upload URI 的上傳要求類型。如果您要使用 /upload URI 上傳資料，此為必填欄位。如果您建立的是僅限中繼資料的檔案，則不必填寫這個欄位。此外，由於小工具不支援資料上傳，因此「試用這個方法」小工具不會顯示這個欄位。

可接受的值為：

  • media：簡易上傳。僅上傳媒體，不含任何中繼資料。
  • multipart - 多部分上傳。在單一要求中上傳媒體及其中繼資料。
  • resumable - 支援續傳的上傳作業。透過可續傳方式上傳檔案 (至少包含兩個要求，其中第一個要求包含中繼資料)。
enforceSingleParent

boolean

已淘汰，我們不再支援在多個資料夾中建立檔案，
ignoreDefaultVisibility

boolean

是否要忽略網域對於建立檔案的預設瀏覽權限設定。網域管理員可以選擇是否讓網域檢視所有上傳的檔案，而這個參數會讓要求略過該行為。權限仍沿用自上層資料夾。
keepRevisionForever

boolean

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

string

匯入圖片期間進行 OCR 處理的語言提示 (ISO 639-1 程式碼)。
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

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