建立及管理檔案

本指南將說明如何建立及管理 Google 雲端硬碟中的檔案。

建立檔案

如要在雲端硬碟中建立不含中繼資料或內容的檔案，請使用 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 雲端硬碟檔案。雲端硬碟可自動產生常見檔案類型的縮圖，您也可以提供應用程式產生的縮圖圖片。詳情請參閱「上傳縮圖」。

複製現有檔案

如要複製檔案並套用所有要求的更新，請使用 files.copy 方法。如要找出要複製的 fileId，請使用 files.list 方法。

請注意，您必須使用適當的 Drive API 範圍來授權呼叫。如要進一步瞭解雲端硬碟範圍，請參閱「選擇 Google Drive API 範圍」。

限制和注意事項

準備複製檔案時，請注意下列限制和注意事項：

  • 權限：

    • copyRequiresWriterPermission 檔案限制會決定哪些使用者可以複製檔案。詳情請參閱「禁止使用者下載、列印或複製檔案」。
    • files 資源的 capabilities/canCopy 欄位會決定使用者能否複製檔案。詳情請參閱「功能」一文。
    • 副本的檔案是由建立副本的使用者所擁有。系統不會複製來源檔案的其他共用設定。如果副本在共用資料夾中建立，則會繼承該資料夾的權限。
    • 複製檔案的擁有權可能會改變，且副本可能不會沿用原始檔案的共用設定。您可能需要重設這些設定。

  • 檔案管理：

    • 某些檔案 (例如第三方捷徑) 一律無法複製。
    • 你只能將檔案複製到一個上層資料夾。不支援指定多個父項。如未指定 parents 欄位，檔案會沿用來源檔案中的所有可偵測父項。
    • 雖然資料夾為檔案類型，但你無法複製資料夾。 請改為建立目的地資料夾，並將現有檔案的 parents 欄位設為目的地資料夾。然後刪除原始來源資料夾。
    • 除非指定新檔案名稱，否則 files.copy 方法會產生與原始檔案名稱相同的檔案。
    • 濫用 files.copy 可能會導致超出 Drive API 配額限制。詳情請參閱「使用限制」一文。

您可以嘗試以下的後續步驟：