创建文件

如需创建不包含元数据或内容的文件,请使用不带参数的 files.create 方法。为该文件指定 kinddrive.fileidname 为“Untitled”,以及 mimeTypeapplication/octet-streamuploadType 被标记为必需项,但默认为 media,因此您实际上不必提供它。

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

创建仅包含元数据的文件

仅包含元数据的文件不包含任何内容。元数据是描述文件的数据(例如 namemimeTypecreatedTime)。name 等字段与用户无关,针对每位用户显示相同,而 viewedByMeTime 等字段包含特定于用户的值。

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

上传缩略图

云端硬盘会自动为许多常见文件类型(例如 Google 文档、表格和幻灯片)生成缩略图。缩略图可帮助用户更好地识别云端硬盘文件。

对于云端硬盘无法生成标准缩略图的文件类型,您可以提供应用生成的缩略图。在创建或更新文件期间,通过在 files 资源上设置 contentHints.thumbnail 字段来上传缩略图。

具体而言:

  • contentHints.thumbnail.image 字段设置为网址和文件名安全 base64 编码的图片(请参阅 RFC 4648 第 5 节)。
  • contentHints.thumbnail.mimeType 字段设置为缩略图的相应 MIME 类型。

如果云端硬盘可以根据文件生成缩略图,它会使用自动生成的缩略图,并忽略您可能已上传的任何缩略图。如果它无法生成缩略图,则会使用您提供的缩略图。

缩略图应遵循以下规则:

  • 可以采用 PNG、GIF 或 JPG 格式上传。
  • 建议的宽度为 1600 像素。
  • 最小宽度为 220 像素。
  • 文件大小上限为 2 MB。
  • 每次保存时,您的应用都应对其进行更新。

如需了解详情,请参阅 files 资源。

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