本指南介绍了如何在 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
文件限制决定了谁可以复制文件。如需了解详情,请参阅禁止用户下载、打印或复制文件。files
资源的capabilities/canCopy
字段决定了用户是否可以复制文件。如需了解详情,请参阅功能。- 创建副本的用户拥有复制的文件。系统不会复制源文件中的其他共享设置。如果副本是在共享文件夹中创建的,则该副本将继承该文件夹的权限。
- 复制的文件的所有权可能会发生更改,并且副本可能不会继承原始文件的共享设置。可能需要重置这些设置。
文件管理:
相关主题
您可以尝试以下后续步骤:
如需在创建或更新文件时上传文件数据,请参阅上传文件数据。
如需在特定文件夹中创建文件,请参阅在特定文件夹中创建文件。
如需使用文件元数据,请参阅管理文件元数据。
如需删除文件,请参阅回收站或删除文件和文件夹。