创建和管理文件

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

创建文件

如需在云端硬盘中创建不包含元数据或内容的文件，请使用不带任何参数的 files.create 方法。该文件的 kind 为 drive.file，id 为“无标题”，name 为“无标题”，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 范围。

限制和注意事项

在准备复制文件时，请注意以下限制和注意事项：

  • 权限：

    • files 资源的 DownloadRestrictionsMetadata 对象决定了谁可以复制文件。如需了解详情，请参阅禁止用户下载、打印或复制您的文件。
    • capabilities.canCopy 字段资源用于确定用户是否可以复制文件。如需了解详情，请参阅了解文件功能。
    • 创建副本的用户拥有该副本文件。来源文件的其他共享设置不会被复制。如果副本是在共享文件夹中创建的，则会沿用该文件夹的权限。
    • 复制文件的所有权可能会发生变化，并且复制文件可能不会沿用原始文件的共享设置。可能需要重置这些设置。

  • 文件管理：

    • 某些文件（例如第三方快捷方式）永远无法复制。
    • 您只能将文件复制到一个父文件夹中。不支持指定多个父级。如果未指定 parents 字段，文件会从源文件继承任何可发现的父级。
    • 虽然文件夹也是一种文件，但您无法复制文件夹。 请改为创建目标文件夹，并将现有文件的 parents 字段设置为目标文件夹。然后，您可以删除原始源文件夹。
    • 除非指定了新文件名，否则 files.copy 方法会生成一个与原始文件同名的文件。
    • 过度使用 files.copy 可能会导致超出 Drive API 配额限制。如需了解详情，请参阅使用限制。

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