文件和文件夹概览

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

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

所有权

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

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

文件类型

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

Blob
一种文件类型,其中包含原始二进制内容或文本内容(例如图片、视频和 PDF),而不是 Google Workspace 文档。 这是云端硬盘分类名称,不指 JavaScript 的 Blob 对象。
文件夹

一种容器,可用于整理云端硬盘上的其他类型的文件。文件夹是仅包含元数据的文件,其 MIME 类型为 application/vnd.google-apps.folder。如需了解详情,请参阅创建文件夹并向其中添加内容。

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

Google Workspace 文档

Google Workspace 应用(例如 Google 文档、表格或幻灯片)创建的文件。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。如需了解详情,请参阅创建指向应用存储内容的 快捷方式文件 。

文件特征

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

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

文件整理

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

Spaces

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

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

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

文件无法在 spaces 之间移动。

Corpora

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

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

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

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

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

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

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