如需创建不包含元数据或内容的文件,请使用不带参数的 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
的文件的快捷方式。如需了解详情,请参阅创建云端硬盘文件的快捷方式。
上传缩略图
云端硬盘会自动为许多常见文件类型(例如 Google 文档、表格和幻灯片)生成缩略图。缩略图可帮助用户更好地识别云端硬盘文件。
对于云端硬盘无法生成标准缩略图的文件类型,您可以提供应用生成的缩略图。在创建或更新文件期间,通过在 files
资源上设置 contentHints.thumbnail
字段来上传缩略图。
具体而言:
- 将
contentHints.thumbnail.image
字段设置为网址和文件名安全 base64 编码的图片(请参阅 RFC 4648 第 5 节)。 - 将
contentHints.thumbnail.mimeType
字段设置为缩略图的相应 MIME 类型。
如果云端硬盘可以根据文件生成缩略图,它会使用自动生成的缩略图,并忽略您可能已上传的任何缩略图。如果它无法生成缩略图,则会使用您提供的缩略图。
缩略图应遵循以下规则:
- 可以采用 PNG、GIF 或 JPG 格式上传。
- 建议的宽度为 1600 像素。
- 最小宽度为 220 像素。
- 文件大小上限为 2 MB。
- 每次保存时,您的应用都应对其进行更新。
如需了解详情,请参阅 files
资源。
相关主题
您可以尝试以下后续步骤:
如需在创建或更新文件时上传文件数据,请参阅上传文件数据。
如需在特定文件夹中创建文件,请参阅在特定文件夹中创建文件。