Google Drive API V3 — 文件列表与筛选

官方 files.list 以 GET 查询获授权范围内的 Drive 文件资源，支持 q、排序、共享盘和分页，需相应 OAuth scope。没有访问账户或列出文件；列表响应不代表已读取文件正文。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：授权云盘文件列表 API · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · e4a2cca0302587400add635dfc6bf7cc48c12ec2022ba0b7409437eaaf30370f

接口为 https://www.googleapis.com/drive/v3/files。请求体应为空；q 可组合搜索条件，默认可能包含回收站文件，排除时需使用 trashed=false 筛选。pageToken 跟随前一页 nextPageToken；files 数组可能不完整。incompleteSearch=true 还表示部分语料未被搜索，尤其 allDrives 时可缩小 corpora。当前正文 pageSize 上限为 1000，服务也可返回较少项目。该方法不提供无授权公共网盘抓取或文件内容下载。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-d0c109fabcd5aed72d6f6980 · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-d0c109fabcd5aed72d6f6980
名片版本: 2
资料更新: 2026-10-24T18:43:48.5907684+00:00
原作者 / 提供者: 未知
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

有效 Google OAuth 授权及适合用途的 scope
可选 q、orderBy、corpora、driveId 和 spaces
实际返回的 nextPageToken 以及共享盘支持参数

输出

files[] 文件资源列表
nextPageToken、kind 和 incompleteSearch 等分页/完整性信息，未实际获取

使用方式

类型: HTTP 接口
入口: 原使用入口
HTTP 方法: GET

鉴权：OAuth 授权。Requires one of官方列出的 Drive OAuth scopes；包括 metadata.readonly、readonly、file 等不同范围，需按用途和实际授权选择，部分受限 scope 需安全评估。

运行前提

已配置 Google OAuth 应用并获得适当授权
选择最小需要的 scope 和实际文件/共享盘范围
请求体为空，正确处理分页和 incompleteSearch

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

未知。本方法参考页未给当前账户价格、免费额度或数值速率限制；不把只读或 Google 官方接口视为无限免费。

未知 · 未知

资料去向

提供者服务器。查询由 Google Drive 服务处理，返回授权范围内的文件资源信息；客户端/AI 可能获得文件元数据。本轮未访问账户，保留期、驻留及授权主体的隐私设置未知。

限制

未登录、授权、列目录、下载文件或修改任何 Drive 数据。
需 OAuth scope，列出的 scope 选择不同会影响可访问范围；不默认申请广泛 drive 权限。
返回列表不等于文件正文或全部账户文件；有 nextPageToken 时需继续，incompleteSearch=true 时可能仍缺结果。
分页 token 通常仅数小时有效；失效需从首请求重新开始，期间文件增删可改变结果。
q 默认可能包含回收站文件；不应将回收站项目当作普通当前文件。
共享盘参数与 corpora 应按实际目标设置；不能把 allDrives 当作所有内容一定完整检索的保证。
部分 OAuth scope 为 restricted，应用可能需要安全评估。

仍需核对

实际账户授权、应用 scope 审批、配额及可用性未核实。
文件资源实际字段、内容可读性及分页完整性未测试。
V3 是 API 路径版本，不是安装版本或已完成的网盘工作流。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T18:42:57.1561062+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

Method: files.list | Google Drive | Google for Developers · 公开记录 · 2026-10-24T18:42:57.1561062+00:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://developers.google.com/workspace/drive/api/reference/rest/v3/files/list",
  "final_url": "https://developers.google.com/workspace/drive/api/reference/rest/v3/files/list",
  "status_code": 200,
  "title": "Method: files.list \u00A0|\u00A0 Google Drive \u00A0|\u00A0 Google for Developers",
  "description": null,
  "checked_at": "2026-10-24T18:42:57.1561062\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-d0c109fabcd5aed72d6f6980",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://developers.google.com/workspace/drive/api/reference/rest/v3/files/list"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。