文件和文件夹概览

Google 云端硬盘按集合整理文件，按类型描述文件，并为每个文件提供特定属性，以便处理文件。

Google Drive API 以 File 资源表示存储在云端硬盘中的文件。

负责

云端硬盘根据用户与内容及其存储位置的关系来整理文件。集合是文件元数据的一部分，用于显示文件在云端硬盘中存储的文件组。“我的云端硬盘”和共享云端硬盘集合之间的主要区别在于文件所有权。单个用户是“我的云端硬盘”中文件的所有者，而群组或组织拥有共享云端硬盘中的文件。

我的云端硬盘
每个用户都有一个名为“My Drive”的“根”文件夹，它充当其主要层次结构，并包含来自此根文件夹的所有子项。用户是此文件夹的主要所有者。
共享云端硬盘
共享云端硬盘是与“我的云端硬盘”并行运作的组织结构。您可以整理共享云端硬盘或“我的云端硬盘”中的单个文件，但不能同时整理二者。不过，可使用 云端硬盘快捷方式将文件或文件夹从共享云端硬盘指向“我的云端硬盘”，反之亦然。

文件类型

云端硬盘按类型描述文件。此列表显示了所有可用的文件类型：

Blob
包含文本、二进制内容（例如图片、视频和 PDF）的文件。
文件夹

一种容器，可用于整理云端硬盘中的其他类型的文件。文件夹是仅包含元数据且 MIME 类型为 application/vnd.google-apps.folder 的文件。

注意：存储在“我的云端硬盘”中的单个文件可以包含在多个文件夹中。一个共享云端硬盘中存储的单个文件只能有一个父级文件夹。

快捷方式

仅包含元数据的文件，指向云端硬盘中的另一个文件。快捷方式文件 MIME 类型为 application/vnd.google-apps.shortcut。有关详情，请参阅创建云端硬盘文件的快捷方式。

第三方快捷方式

仅包含元数据的文件，链接到存储于第三方存储系统中的内容。第三方快捷方式文件 MIME 类型为 application/vnd.google-apps.drive-sdk。如需了解详情，请参阅创建外部文件的快捷方式。

Google Workspace 文档

Google Workspace 应用创建的文件，例如 Google 文档、表格或幻灯片。MIME 类型格式为 application/vnd.google-apps.*app*，其中 app 是应用名称（例如 application/vnd.google-apps.spreadsheet 表示 Google 表格文件）。如需查看云端硬盘和 Google Workspace 专用 MIME 类型列表，请参阅 Google Workspace 和 Google 云端硬盘支持的 MIME 类型。

注意：您无法将文件夹、快捷方式、第三方快捷方式和 Google Workspace 文档上传或下载到云端硬盘中。但是，如果文档使用的是兼容的格式，您可以上传或导出 Google Workspace 文档。例如，您可以在导入 PDF 时创建 Google 文档。同样，您也可以将 Google 幻灯片演示文稿导出为 Microsoft PowerPoint 文件。

文件特征

以下列出了云端硬盘文件的一些特征：

文件 ID
每个文件的唯一不透明 ID。文件 ID 会在文件的整个生命周期内保持不变，即使文件名发生变化也是如此。搜索表达式用于按名称、类型、内容、父级容器、所有者或其他元数据查找文件。
元数据
描述文件内容的数据。此数据包括名称、类型、创建和修改时间。某些元数据字段（如 name）与用户无关，并且对每位用户的显示方式相同。其他字段（如 capabilities 和 viewedByMeDate）包含特定于用户的值。文件类型（例如图片和视频）包含从 EXIF 和其他嵌入式元数据中提取的其他元数据。
权限
授予用户、群组、网域或全世界访问文件或文件夹层次结构的权限。用户可以通过访问控制列表 (ACL)（文件权限列表）控制谁可以访问文件。有关详情，请参阅共享文件、文件夹和驱动器。
内容
文件的二进制文件或文本正文。您可存储在 Google 云端硬盘中的一些内容示例包括图片、视频、文本和 PDF。
修订历史记录
仅记录文件内容更改的记录，而不包含文件元数据。如需详细了解修订版本，请参阅变更和修订版本概览。
缩略图
文件的图形表示。云端硬盘会自动为许多常见的文件类型生成缩略图。对于云端硬盘无法呈现的快捷方式和其他文件类型，您可以提供缩略图。

文件整理

Drive API 将文件整理到存储位置（称为 spaces）和集合（称为 corpora）。

聊天室

彼此隔离的特定存储位置。云端硬盘中的所有内容都存储在以下 2 种定义的空间中：drive 和 appDataFolder。

  • drive - 包括云端硬盘中所有用户可见的文件。用户上传的 PDF、文档、Google 文档、快捷方式以及其他内容都位于 drive 空间内。

  • appDataFolder - 包括每位用户的应用数据。应用通常存储配置文件和其他无法直接供用户访问的数据。

文件无法在空格之间移动。

分类

用于缩小文件和文件夹搜索范围的文件集合。云端硬盘的资料库包括：user、domain、drive 和 allDrives。

  • user - 包括该用户在“我的云端硬盘”中创建和打开的所有文件，以及在“与我共享”中直接与该用户共享的文件。

  • drive - 包括单个共享云端硬盘中包含的所有文件（以 driveId 表示）。

  • domain - 包括与用户网域共享的所有可搜索文件。

  • allDrives - 包括用户所属的共享云端硬盘中的所有文件，以及“我的云端硬盘”和“与我共享”中的所有文件。请谨慎使用 allDrives 语料库，因为它涵盖范围广，并且可能会影响性能。尽可能使用 user 或 drive（而非 allDrives）来提高效率。

随着权限和所有权变更，文件可以在资料库中自由移动。

后续步骤

您可以执行以下几个后续步骤：