建立及管理檔案

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

建立檔案

如要在 Google 雲端硬碟中建立不含中繼資料或內容的檔案，請使用 files.create() 方法，但不附加參數。檔案會獲得 drive.file 的 kind、一個 id、一個「Untitled」的 name 和一個 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 雲端硬碟檔案的捷徑」一文。

管理縮圖

縮圖可協助使用者辨識雲端硬碟檔案。雲端硬碟可自動為常見檔案類型產生縮圖，您也可以提供應用程式產生的縮圖圖片。詳情請參閱「上傳縮圖」。

複製現有檔案

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

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

限制和注意事項

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

  • 權限：

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

  • 檔案管理：

    • 部分檔案 (例如第三方捷徑) 無法複製。
    • 您只能將檔案複製到一個父資料夾。系統不支援指定多個父項。如果未指定 parents 欄位，檔案會從來源檔案繼承任何可探索的父項。
    • 雖然資料夾是一種檔案類型，但您無法複製資料夾。請改為建立目的地資料夾，並將現有檔案的 parents 欄位設為目的地資料夾。接著，您就可以刪除原始來源資料夾。
    • 除非指定新檔案名稱，否則 files.copy() 方法會產生與原始檔案相同名稱的檔案。
    • files.copy() 的使用量過多可能會導致 Drive API 配額超出上限。詳情請參閱「使用限制」。

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