如要建立不含中繼資料或內容的檔案,請使用不含參數的 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
資源。
相關主題
您可以嘗試以下的後續步驟:
如要在建立或更新檔案時上傳檔案資料,請參閱上傳檔案資料。
如要在特定資料夾中建立檔案,請參閱在特定資料夾中建立檔案一節。