Files: get

根据 ID 获取文件的元数据或内容。立即尝试

如果您提供网址参数 alt=media,则响应会在响应正文中包含文件内容。仅当文件存储在云端硬盘中时,使用 alt=media 下载内容才有效。要下载 Google 文档、表格和幻灯片,请改用 files.export。如需详细了解如何下载文件,请参阅下载和导出文件

请求

HTTP 请求

GET https://www.googleapis.com/drive/v3/files/fileId

参数

参数名称 说明
路径参数
fileId string 文件的 ID。
可选的查询参数
acknowledgeAbuse boolean 用户是否了解下载已知恶意软件或其他滥用文件的风险。仅当 Alt=media 时才适用。 (默认值:false
fields string 要包含在响应中的字段的路径。如果未指定,则响应包含此方法的默认默认字段集。对于开发,您可以使用特殊值 * 返回所有字段,但只需选择所需的字段,即可获得更好的性能。如需了解详情,请参阅返回文件的特定字段
includeLabels string 以英文逗号分隔的 ID 列表,应包含在响应的 labelInfo 部分中。
includePermissionsForView string 指定要在响应中包含的其他视图的权限。仅支持“已发布”。
supportsAllDrives boolean 发出请求的应用是否支持“我的云端硬盘”和共享云端硬盘。 (默认值:false
supportsTeamDrives boolean 已废弃的使用支持 allAllDrives。 (默认值:false

授权

此请求至少授予以下其中一个范围的授权:

范围
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.photos.readonly

某些范围会受到限制,需要对应用进行安全性评估才能使用。如需了解详情,请参阅身份验证和授权页面。

请求正文

使用此方法时请勿提供请求正文。

响应

默认情况下,这将在响应正文中返回文件资源。如果您提供网址参数 alt=media,则响应会在响应正文中包含文件内容。仅当文件存储在云端硬盘中时,使用 alt=media 下载内容才有效。要下载 Google 文档、表格和幻灯片,请改用 files.export。如需详细了解如何下载文件,请参阅下载和导出文件

试试看!

请使用下面的 API Explorer 针对实际数据调用此方法,然后查看响应。