创建和管理文件

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

创建文件

要在云端硬盘中创建不含元数据或内容的文件，请执行以下操作： 使用 files.create 方法，其中不包含 参数。该文件的 kind 为 drive.file，id 为 name， “Untitled”，mimeType 为 application/octet-stream。uploadType为 但默认值为 media，因此您实际上无需提供 。

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

创建仅包含元数据的文件

仅包含元数据的文件不包含任何内容。元数据就是数据（例如 name、 mimeType 和 createdTime）。像 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 配额限制。有关详情，请参阅用法 限制。

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