文件和文件夹概览

Google 云端硬盘会将文件整理到文件集中，按类型描述文件，并为每个文件提供特定属性，以便于操作文件。

Google Drive API 将存储在云端硬盘中的文件表示为 files 资源。

所有权

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

我的云端硬盘
每个用户都有一个名为“我的云端硬盘”的“根”文件夹，该文件夹充当其主要层次结构，其中包含从此根文件夹派生的所有内容。该用户是此文件夹的主要所有者。
共享云端硬盘
共享云端硬盘是云端硬盘中与“我的云端硬盘”并行的组织结构。您可以在共享云端硬盘或“我的云端硬盘”中整理单个文件，但不能同时在二者中整理。不过， 云端硬盘快捷方式可用于指向共享云端硬盘中的文件或文件夹，也可以指向“我的云端硬盘”中的文件或文件夹。

文件类型

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

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

您可以使用此容器在云端硬盘上整理其他类型的文件。文件夹是仅包含元数据且具有 MIME 类型 application/vnd.google-apps.folder 的文件。如需了解详情，请参阅创建和填充文件夹。

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

Google Workspace 文档

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

快捷键

指向云端硬盘中另一个文件的纯元数据文件。快捷方式文件的 MIME 类型为 application/vnd.google-apps.shortcut。如需了解详情，请参阅创建 Google 云端硬盘文件的快捷方式。

第三方快捷方式

一个仅包含元数据的文件，用于关联到存储在第三方存储系统中的内容。第三方快捷方式文件的 MIME 类型为 application/vnd.google-apps.drive-sdk。如需了解详情，请参阅创建指向应用存储的内容的快捷方式文件。

文件特征

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

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

文件组织

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

聊天室

彼此隔离的特定存储位置。云端硬盘中的所有内容都存储在这两个已定义的空间中：drive 和 appDataFolder。

  • drive：包括在云端硬盘中创建的所有可供用户查看的文件。PDF、文档、Google 文档、快捷方式和用户上传的其他内容位于 drive 空间中。

  • appDataFolder：包含按用户的应用数据。应用通常会存储配置文件和其他不打算供用户直接访问的数据。

文件无法在 spaces 之间移动。

Corpora

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

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

  • drive：包含单个共享云端硬盘中包含的所有文件，如 driveId 所示。

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

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

文件可以在 corpora 之间自由移动，权限和所有权也会随之变化。

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