Google 云端硬盘会将文件整理为集合,按类型描述文件,并提供每个文件的特定属性,以便于操作文件。
Google Drive API 将作为 File
资源存储在云端硬盘中的文件表示。
所有权
云端硬盘根据用户与内容的关系及其存储位置来整理文件。文件集作为文件元数据的一部分指定,用于显示云端硬盘中存储了哪组文件。“我的云端硬盘”和共享云端硬盘集合的主要区别在于文件所有权。单个用户是其“我的云端硬盘”中文件的所有者,而群组或组织拥有共享云端硬盘中的文件。
- 我的云端硬盘
- 每个用户都有一个名为“我的云端硬盘”的“根”文件夹,该文件夹充当其主要层次结构,包含位于此根文件夹中的所有内容。该用户是此文件夹的主要所有者。
- 共享云端硬盘
- 共享云端硬盘是云端硬盘中与“我的云端硬盘”并行的组织结构。您可以在共享云端硬盘或“我的云端硬盘”中整理单个文件,但不能同时整理这两者。不过, 云端硬盘快捷方式可用于指向共享云端硬盘和“我的云端硬盘”中的文件或文件夹,反之亦然。
文件类型
云端硬盘按类型描述文件。此列表显示了所有可用的文件类型:
- Blob
- 包含文本或二进制内容(如图片、视频和 PDF)的文件。
- 文件夹
一种容器,可用于整理云端硬盘上其他类型的文件。文件夹是仅包含元数据且 MIME 类型为
application/vnd.google-apps.folder
的文件。注意:存储在“我的云端硬盘”中的单个文件可以包含在多个文件夹中。存储在共享云端硬盘中的单个文件只能有一个父文件夹。
- 快捷键
指向云端硬盘上其他文件的仅包含元数据的文件。快捷方式文件 MIME 类型为
application/vnd.google-apps.shortcut
。如需了解详情,请参阅创建云端硬盘文件的快捷方式。- 第三方快捷方式
一种仅包含元数据的文件,链接到存储在第三方存储系统中的内容。第三方快捷方式文件 MIME 类型为
application/vnd.google-apps.drive-sdk
。如需了解详情,请参阅创建外部文件的快捷方式。- 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 类型。
注意:您无法将文件夹、快捷方式、第三方快捷方式和 Google Workspace 文档上传到云端硬盘或从中下载。但是,如果它们使用兼容的格式,则您可以上传或导出 Google Workspace 文档。例如,您可以在导入 PDF 时创建 Google 文档。同样,您也可以将 Google 幻灯片演示文稿导出为 Microsoft PowerPoint 文件。
文件特性
此列表会显示云端硬盘文件的一些特性:
- 文件 ID
- 每个文件的唯一不透明 ID。文件 ID 在文件的整个生命周期内保持不变,即使文件名发生更改也是如此。搜索表达式用于按名称、类型、内容、父级容器、所有者或其他元数据查找文件。
- Metadata
- 描述文件内容的数据。这些数据包括名称、类型、创建和修改时间。某些元数据字段(如
name
)与用户无关,对于每个用户来说都是相同的。其他字段(如capabilities
和viewedByMeDate
)包含用户特定的值。文件类型(如图片和视频)包含从 EXIF 和其他嵌入式元数据中提取的其他元数据。 - 权限
- 向用户、群组、网域或所有人授予访问文件或文件夹层次结构的权限。用户可使用访问控制列表 (ACL)(列出了文件的权限列表)控制哪些人可以访问文件。如需了解详情,请参阅共享文件、文件夹和云端硬盘。
- 内容
- 文件的二进制文件或文本正文。您可以在 Google 云端硬盘中存储的内容示例包括图片、视频、文本和 PDF。
- 修订历史记录
- 仅包括文件内容(而非文件元数据)的更改记录。如需详细了解修订版本,请参阅变更和修订版本概览。
- 缩略图
- 文件的图形表示。云端硬盘会自动为许多常见文件类型生成缩略图。对于云端硬盘无法呈现的快捷方式和其他文件类型,您可以提供缩略图。
文件组织
Drive API 将文件整理到存储位置(称为 spaces
)和集合(称为 corpora
)。
- 聊天室
特定存储位置相互隔离。云端硬盘中的所有内容均存储在以下两个已定义的空间之一中:
drive
和appDataFolder
。drive
- 包括在云端硬盘中创建的所有用户可见的文件。用户上传的 PDF、文档、Google 文档、快捷方式和其他内容都位于drive
空间中。appDataFolder
- 包括每位用户的应用数据。应用通常会存储不应让用户直接访问的配置文件和其他数据。
文件无法在空格之间移动。
- 语料库
用于缩小文件和文件夹搜索范围的文件集合。云端硬盘的语料库为:
user
、domain
、drive
和allDrives
。user
- 包括用户在“我的云端硬盘”中创建和打开的所有文件,以及在“与我共享”中直接与用户共享的文件。drive
- 包括单个共享云端硬盘中包含的所有文件,以driveId
指示。domain
- 包括与用户网域共享的所有可搜索文件。allDrives
- 包括用户作为其成员的共享云端硬盘中的所有文件,以及“我的云端硬盘”和“与我共享”中的所有文件。allDrives
语料库范围很广,可能会影响性能,因此请谨慎使用。尽可能使用user
或drive
而不是allDrives
,以提高效率。
随着权限和所有权的变更,文件可以在语料库之间自由移动。
后续步骤
您可以执行以下几个后续步骤:
- 了解如何将文件数据上传到 Google 云端硬盘。
- 了解如何从云端硬盘下载和导出文件。
- 了解如何存储应用专属数据。
- 了解如何在网页上显示 Google 选择器。