文件和文件夹概览

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。如需了解详情,请参阅创建指向云端硬盘文件的快捷方式

第三方快捷方式

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

文件特征

此列表显示了云端硬盘文件的一些特征:

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

文件组织结构

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

聊天室

彼此隔离的特定存储位置。Google 云端硬盘中的所有内容都存储在以下两个已定义的空间之一中:driveappDataFolder

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

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

文件无法在 spaces 之间移动。

Corpora

用于缩小文件和文件夹搜索范围的文件集合。Google 云端硬盘的语料库包括:userdomaindriveallDrives

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

  • drive:包括单个共享云端硬盘中的所有文件,如 driveId 中所示。

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

  • allDrives:包括用户是成员的共享云端硬盘中的所有文件,以及“我的云端硬盘”和“与我共享”中的所有文件。 请谨慎使用 allDrives 语料库,因为它具有广泛的范围,可能会影响效果。为了提高效率,请尽可能使用 userdrive,而不是 allDrives

文件可以在 corpora 之间自由移动,因为权限和所有权会发生变化。

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