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之间自由移动,因为权限和所有权会发生变化。
相关主题
您可以执行以下几个后续步骤:
- 了解如何创建和管理文件。
- 了解如何创建文件夹并向其中添加内容。
- 了解如何上传文件数据。
- 了解如何下载和导出文件。
- 了解如何存储应用专用数据。
- 了解如何在网页上显示 Google 选择器。