本指南說明如何在 Google 雲端硬碟中建立及管理檔案。
建立檔案
如要在雲端硬碟建立不含中繼資料或內容的檔案,請使用不含參數的 files.create
方法。檔案會指定 drive.file
的 kind
、id
、name
的「Untitled」,以及 application/octet-stream
的 mimeType
。uploadType
標示為必要,但預設為 media
,因此您實際上不必提供該值。
如要進一步瞭解雲端硬碟檔案限制,請參閱檔案和資料夾限制。
建立僅含中繼資料的檔案
僅中繼資料的檔案不含任何內容。中繼資料是描述檔案的資料 (例如 name
、mimeType
和 createdTime
)。name
這類欄位可供使用者通用,且每位使用者皆會顯示相同的資訊,而 viewedByMeTime
這類欄位則包含使用者專屬值。
以 MIME 類型 application/vnd.google-apps.folder
的資料夾為例,這類資料夾就是純中繼資料檔案。詳情請參閱「建立及填入資料夾」一文。另一個例子是捷徑會指向 Google 雲端硬碟中 MIME 類型為 application/vnd.google-apps.shortcut
的其他檔案。詳情請參閱「建立 Google 雲端硬碟檔案的捷徑」一文。
管理縮圖
縮圖可協助使用者辨識雲端硬碟檔案。Drive 可自動為常見的檔案類型產生縮圖,您也可以提供應用程式產生的縮圖圖片。詳情請參閱「上傳縮圖」。
複製現有檔案
如要複製檔案並套用任何要求的更新,請使用 files.copy
方法。如要找到要複製的 fileId
,請使用 files.list
方法。
請注意,您必須使用適當的 Drive API 範圍來授權呼叫。如要進一步瞭解雲端硬碟範圍,請參閱「選擇 Google Drive API 範圍」。
限制和注意事項
準備複製檔案時,請注意下列限制和注意事項:
權限:
copyRequiresWriterPermission
檔案限制會決定誰可以複製檔案。詳情請參閱「禁止使用者下載、列印或複製檔案」。files
資源的capabilities/canCopy
欄位會決定使用者是否可以複製檔案。詳情請參閱「功能」。- 建立副本的使用者擁有複製的檔案。不會複製來源檔案的其他分享設定。如果副本是在共用資料夾中建立,就會沿用該資料夾的權限。
- 複製的檔案擁有權可能會變更,且複製的檔案可能不會繼承原始檔案的共用設定。這些設定可能需要重設。
檔案管理:
相關主題
以下是您可以嘗試的後續步驟:
如要在建立或更新檔案時上傳檔案資料,請參閱「上傳檔案資料」。
如要在特定資料夾中建立檔案,請參閱「在特定資料夾中建立檔案」。
如要使用檔案中繼資料,請參閱「管理檔案中繼資料」。
如要刪除檔案,請參閱「將檔案和資料夾移至垃圾桶或刪除」一文。