如要建立不含中繼資料或內容的檔案，請使用不含參數的 files.create 方法。檔案會獲派 drive.file 的 kind、id、「未命名」的 name，以及 application/octet-stream 的 mimeType。uploadType 標示為必要，但預設為 media，因此您不必實際提供。
如要進一步瞭解雲端硬碟檔案限制，請參閱檔案與資料夾限制。
建立中繼資料專用的檔案
只有中繼資料的檔案不含任何內容。中繼資料是描述檔案的資料 (例如 name、mimeType 和 createdTime)。name 這類欄位適用於各使用者通用，因此每位使用者都會顯示相同的欄位，而 viewedByMeTime 等欄位則包含使用者專屬值。
一個只有中繼資料的檔案範例就是具有 MIME 類型 application/vnd.google-apps.folder 的資料夾。詳情請參閱「建立並填入資料夾」。另一個範例是指向雲端硬碟上以 MIME 類型 application/vnd.google-apps.shortcut 指向其他檔案的捷徑。詳情請參閱「建立雲端硬碟檔案的捷徑」。
上傳縮圖
雲端硬碟會自動產生 Google 文件、試算表和簡報等多種常見檔案類型的縮圖。縮圖可協助使用者輕鬆找到雲端硬碟檔案。
對於 Google 雲端硬碟無法產生標準縮圖的檔案類型，您可以提供應用程式產生的縮圖。在建立或更新檔案期間，透過設定 files 資源的 contentHints.thumbnail 欄位來上傳縮圖。
詳細說明：
- 將
contentHints.thumbnail.image欄位設為網址和檔案名稱安全採用 Base64 編碼的圖片 (請參閱 RFC 4648 第 5 節)。 - 將
contentHints.thumbnail.mimeType欄位設為縮圖的適當 MIME 類型。
如果 Google 雲端硬碟可以從檔案產生縮圖，則會使用自動產生的縮圖，並忽略所有已上傳的檔案。如果系統無法產生縮圖，就會使用您提供的縮圖。
縮圖必須遵守下列規則：
- 可使用 PNG、GIF 或 JPG 格式上傳。
- 建議寬度為 1600 像素。
- 寬度不得少於 220 像素。
- 檔案大小上限為 2 MB。
- 每次儲存時，應用程式應該會更新這些值。
詳情請參閱 files 資源。
相關主題
您可以嘗試以下的後續步驟：
如要在建立或更新檔案時上傳檔案資料，請參閱上傳檔案資料。
如要在特定資料夾中建立檔案，請參閱在特定資料夾中建立檔案一節。