Google 雲端硬碟會將檔案整理到集合中,並依類型說明檔案,以及提供每個檔案的特定屬性,方便您操作檔案。
Google Drive API 會將儲存在雲端硬碟中的檔案表示為 files
資源。
擁有權
雲端硬碟會根據使用者與內容的關係和儲存位置整理檔案。集合會指定為檔案中繼資料的一部分,用來顯示檔案在 Google 雲端硬碟中儲存的檔案群組。「我的雲端硬碟」和共用雲端硬碟集合的主要差異在於檔案擁有權。「我的雲端硬碟」中的檔案由單一使用者擁有,而共用雲端硬碟中的檔案則由群組或機構擁有。
- 我的雲端硬碟
- 每位使用者都有一個名為「我的雲端硬碟」的「根」資料夾,做為主要階層,其中包含從這個根資料夾衍生的所有內容。使用者是這個資料夾的主要擁有者。
- 共用雲端硬碟是雲端硬碟中的組織結構,與「我的雲端硬碟」平行。您可以整理共用雲端硬碟或「我的雲端硬碟」中的個別檔案,但無法同時整理兩者。不過, 雲端硬碟捷徑可用來將共用雲端硬碟中的檔案或資料夾指向「我的雲端硬碟」,反之亦然。
檔案類型
雲端硬碟會依類型說明檔案。這份清單列出所有可用的檔案類型:
- Blob
- 內含文字或二進位內容的檔案,例如圖片、影片和 PDF。
- 資料夾
可用於整理雲端硬碟上其他類型檔案的容器。資料夾是只包含中繼資料的檔案,MIME 類型為
application/vnd.google-apps.folder
。詳情請參閱「建立及填入資料夾」。注意:儲存在「我的雲端硬碟」的單一檔案可以位於多個資料夾中。儲存在共用雲端硬碟中的單一檔案只能有一個上層資料夾。
- Google Workspace 文件
Google 文件、試算表或簡報等 Google Workspace 應用程式建立的檔案。MIME 類型格式為
application/vnd.google-apps.*app*
,其中 app 是應用程式名稱 (例如試算表檔案的application/vnd.google-apps.spreadsheet
)。如需雲端硬碟和 Google Workspace 專屬 MIME 類型清單,請參閱「Google Workspace 和 Google 雲端硬碟支援的 MIME 類型」。- 快速鍵
僅含中繼資料的檔案,指向雲端硬碟中的另一個檔案。捷徑檔案 MIME 類型為
application/vnd.google-apps.shortcut
。詳情請參閱「建立雲端硬碟檔案的捷徑」。- 第三方捷徑
僅含中繼資料的檔案,可連結至儲存在第三方儲存系統的內容。第三方捷徑檔案的 MIME 類型為
application/vnd.google-apps.drive-sdk
。詳情請參閱「建立應用程式儲存內容的捷徑檔案」。
檔案特性
這份清單列出雲端硬碟檔案的部分特徵:
- 存取權提議
- 要求者向核准者提出的提案,要求授予收件者存取 Google 雲端硬碟項目的權限。詳情請參閱「列出及解決待處理的存取權提案」。
- 內容
- 檔案的二進位或文字主體。您可以在雲端硬碟中儲存圖片、影片、文字和 PDF 等內容。
- 檔案 ID
- 每個檔案的專屬不透明 ID。檔案 ID 在檔案的整個生命週期內都不會變動,即使檔案名稱變更也一樣。搜尋運算式可用於依名稱、類型、內容、上層容器、擁有者或其他中繼資料尋找檔案。
- 中繼資料
- 描述檔案內容的資料。這類資料包括名稱、類型、建立時間和修改時間。部分中繼資料欄位 (例如
name
) 與使用者無關,因此每位使用者看到的內容都相同。其他欄位 (例如capabilities
和viewedByMeDate
) 則包含使用者專屬值。圖片和影片等檔案類型含有從 EXIF 和其他嵌入式中繼資料擷取的額外中繼資料。詳情請參閱「管理檔案中繼資料」。 - 權限
- 授予使用者、群組、網域或全球存取檔案或資料夾階層的權限。使用者可透過存取控制清單 (ACL) 控管檔案存取權,這份清單會列出檔案的權限。詳情請參閱「共用檔案、資料夾和雲端硬碟」。
- 修訂版本記錄
- 記錄的只有檔案內容的變更,不包括檔案中繼資料。如要進一步瞭解修訂版本,請參閱變更和修訂版本總覽。
- 縮圖
- 檔案的圖示。雲端硬碟會自動為許多常見檔案類型產生縮圖。如果是捷徑和雲端硬碟無法算繪的其他檔案類型,你可以提供縮圖。詳情請參閱「上傳縮圖」。
檔案整理
雲端硬碟 API 會將檔案整理到儲存位置 (稱為 spaces
) 和集合 (稱為 corpora
)。
- Spaces
彼此隔離的特定儲存位置。Google 雲端硬碟中的所有內容都會儲存在以下兩個定義的空間之一:
drive
和appDataFolder
。drive
:包括在雲端硬碟中建立的所有使用者可見檔案。使用者上傳的 PDF、文件、Google 文件、捷徑和其他內容會位於drive
空間。appDataFolder
:包括每位使用者的應用程式資料。應用程式通常會儲存設定檔和其他不適合使用者直接存取的資料。
檔案無法在
spaces
之間移動。- Corpora
檔案集合,用於縮小檔案和資料夾的搜尋範圍。雲端硬碟的語料庫為:
user
、domain
、drive
和allDrives
。user
:包括使用者在「我的雲端硬碟」中建立及開啟的所有檔案,以及在「與我共用」中直接與使用者共用的檔案。drive
:包含單一共用雲端硬碟中的所有檔案,如driveId
所示。domain
:包括與使用者網域共用的所有可搜尋檔案。allDrives
:包括使用者所屬共用雲端硬碟中的所有檔案,以及「我的雲端硬碟」和「與我共用」中的所有檔案。請謹慎使用allDrives
語料庫,因為範圍廣泛,可能會影響成效。盡可能使用user
或drive
,而非allDrives
,以提高效率。
檔案可在
corpora
之間自由移動,權限和擁有權也會隨之變更。
相關主題
您可以採取下列幾個後續步驟:
- 瞭解如何建立及管理檔案。
- 瞭解如何建立及填入資料夾。
- 瞭解如何上傳檔案資料。
- 瞭解如何下載及匯出檔案。
- 瞭解如何儲存應用程式專屬資料。
- 瞭解如何在網頁上顯示 Google 挑選器。