文件和文件夹概览

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)与用户无关,对于每个用户都相同。其他字段(例如 capabilitiesviewedByMeDate)包含特定于用户的值。图片和视频等文件类型包含从 EXIF 和其他嵌入式元数据中提取的其他元数据。如需了解详情,请参阅管理文件 元数据
权限
授予用户、群组、网域或所有人访问文件或文件夹层次结构的权限。用户可以使用访问控制列表 (ACL) 控制谁可以访问文件,该列表是文件的权限列表。如需了解更多 信息,请参阅共享文件、文件夹和 云端硬盘
修订历史记录
仅记录对文件内容的更改,而不记录对文件元数据的更改。如需详细了解修订版本,请参阅更改和修订版本概览
缩略图
文件的图形表示。云端硬盘会自动为许多常见文件类型生成缩略图。对于云端硬盘无法呈现的快捷方式和其他文件类型,您可以提供缩略图。如需了解详情,请参阅上传缩略图

文件整理

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

Spaces

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

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

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

文件无法在 spaces 之间移动。

Corpora

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

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

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

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

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

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

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