Method: files.get

根据 ID 获取文件的元数据或内容。如需了解详情，请参阅搜索文件和文件夹。

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

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
fileId

string

文件的 ID。

查询参数

参数
acknowledgeAbuse

boolean

用户是否确认下载已知恶意软件或其他滥用文件的风险。仅当 alt 参数设置为 media 且用户是相应文件的所有者或相应文件所在共享云端硬盘的组织者时，此参数才适用。
supportsAllDrives

boolean

请求访问的应用是否同时支持“我的云端硬盘”和共享云端硬盘。
supportsTeamDrives
(deprecated)

boolean

已弃用：请改用 supportsAllDrives。
includePermissionsForView

string

指定要在响应中包含哪些其他视图的权限。仅支持 published。
includeLabels

string

以英文逗号分隔的标签 ID 列表，用于指定要在响应的 labelInfo 部分中包含的标签。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文包含一个 File 实例。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

某些范围受到限制，您的应用需要通过安全评估才能使用这些范围。如需了解详情，请参阅授权指南。