本文說明為檔案命名以及使用縮圖和可建立索引文字等中繼資料的重要考量。如要開始插入和擷取檔案，請參閱檔案參考資料。
指定檔案名稱和副檔名
使用 API 插入檔案時，應用程式應在 title 屬性中指定副檔名。例如，插入 JPEG 檔案的作業應在中繼資料中指定類似 "name": "cat.jpg" 的內容。
後續的 GET 回應可填入唯讀 fileExtension 屬性，並填入原先在 name 屬性中指定的擴充功能。當 Google 雲端硬碟使用者要求下載檔案，或是透過同步用戶端下載檔案時，雲端硬碟會根據標題建立完整的檔案名稱 (包含副檔名)。如果缺少擴充功能，雲端硬碟會嘗試根據檔案的 MIME 類型判斷副檔名。
儲存可建立索引的文字
如果雲端硬碟識別出檔案類型 (包括文字文件、PDF、含有文字的圖片和其他常見類型)，雲端硬碟就會自動為文件建立索引。
如果您的應用程式儲存其他類型的檔案 (例如繪圖、影片和捷徑)，您可以在檔案的 contentHints.indexableText 欄位中提供可建立索引的文字，藉此提升曝光率。
可建立索引的文字會以 HTML 格式建立索引。如果您儲存可建立索引的文字字串 <section attribute="value1">Here's some text</section>，系統會為「這裡有一些文字」建立索引，但「value1」則不會。因此，將 XML 儲存為可建立索引的文字，不像儲存 HTML 一樣實用。
指定 indexableText 時，請注意以下幾點：
contentHints.indexableText的大小上限為 128 KB。- 記錄您希望使用者搜尋的關鍵字詞和概念。
- 請勿嘗試按照重要性排序文字，因為索引工具可以有效為您執行此作業。
- 應用程式應該會在每次儲存時更新可建立索引的文字。
- 請確保文字與檔案內容或中繼資料相關。
這個最後重點或許看似清楚，但很重要。不建議新增常用搜尋字詞，強制檔案出現在搜尋結果中。這可能會讓使用者感到不悅，甚至可能會鼓勵使用者刪除檔案。
上傳縮圖
雲端硬碟會自動為許多常見的檔案類型產生縮圖。針對雲端硬碟無法轉譯的捷徑和其他檔案類型，您可以提供應用程式產生的縮圖圖片。在 create 或 update 呼叫期間，在檔案資源中設定 contentHints.thumbnail 屬性以上傳縮圖，如下所示：
- 將
contentHints.thumbnail.image設為受網址安全且採用 Base64 編碼的圖片 (請參閱 RFC 4648 第 5 節)。 - 將
contentHints.thumbnail.mimeType設為圖片格式的適當類型。
如果雲端硬碟可以從檔案產生縮圖，則會使用產生的縮圖並忽略您上傳的任何圖片。如果無法產生縮圖， 系統一律會使用縮圖 (如有提供)。注意事項：
- 您可以上傳 PNG、GIF 或 JPG 格式的縮圖。
- 建議寬度為 1600 像素。
- 縮圖的檔案大小上限為 2 MB。
- 縮圖的寬度下限為 220 像素。
- 應用程式應在每次儲存時更新縮圖。
詳情請參閱檔案參考資料。