创建和管理文件

本指南介绍如何在 Google 云端硬盘中创建和管理文件。

创建文件

要在云端硬盘中创建不含元数据或内容的文件,请执行以下操作: 使用 files.create 方法,其中不包含 参数。该文件的 kinddrive.fileidname, “Untitled”,mimeTypeapplication/octet-streamuploadType为 但默认值为 media,因此您实际上无需提供 。

如需详细了解云端硬盘文件限制,请参阅文件和 文件夹限制

创建仅包含元数据的文件

仅包含元数据的文件不包含任何内容。元数据就是数据(例如 namemimeTypecreatedTime)。像 name 这样的字段是 与用户无关,并且对每个用户显示相同,而诸如 viewedByMeTime 包含特定于用户的值。

一个仅包含元数据的文件的示例是 MIME 类型的文件夹 application/vnd.google-apps.folder。有关详情,请参阅创建和 填充文件夹。另一个示例是 指向云端硬盘中具有 MIME 类型的另一个文件 application/vnd.google-apps.shortcut。有关详情,请参阅创建 指向云端硬盘文件的快捷方式

管理缩略图

缩略图有助于用户识别云端硬盘文件。云端硬盘 可以自动生成常见文件类型的缩略图, 应用生成的缩略图图片有关详情,请参阅上传 缩略图

复制现有文件

如需复制文件并应用任何请求的更新,请使用 files.copy 方法。要查找 fileId 请使用 files.list 方法。

请注意,您需要使用适当的 Drive API 范围来授权 调用。如需详细了解云端硬盘范围,请参阅选择 Google Drive API 作用域

限制和注意事项

当您准备复制文件时,请注意以下限制和注意事项:

  • 权限

    • copyRequiresWriterPermission 文件限制决定了哪些人可以 复制文件。有关详情,请参阅禁止用户 下载、打印或复制 文件
    • 此 API 的 capabilities/canCopy 字段 files 资源决定了 用户是否可以复制文件如需了解详情,请参阅 功能
    • 创建副本的用户拥有所复制的文件。无其他共享 都会复制源文件中的设置如果副本是在 共享文件夹就会继承该文件夹的权限。
    • 复制的文件的所有权可能会发生变化,并且该副本可能不会沿用 原始文件的共享设置。这些设置可能需要 重置。
  • 文件管理

    • 某些文件,如第三方 快捷方式,绝不能 已复制。
    • 一个文件只能复制到一个父级文件夹。指定多个 不支持。如果未指定 parents 字段,则 文件会继承源文件中任何可发现的父文件。
    • 即使文件夹是文件类型,您也无法复制文件夹。 而是创建目标文件夹,并将 parents 字段的 将现有文件复制到目标文件夹然后,您可以删除 原始源文件夹
    • 除非指定新的文件名,否则 files.copy 方法会生成 与原始文件同名。
    • 过度使用 files.copy 可能会导致超出 Drive API 配额限制。有关详情,请参阅用法 限制

您可以尝试以下后续步骤: