NavoNavo

Help your AI find the right capability, and help others find yours.

Integration guide
Back

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

Close

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

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

Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.

Stable ID
cap-d0c109fabcd5aed72d6f6980
Card version
2
Updated
2026-10-24T18:43:48.5907684+00:00
Ownership state
unclaimed
Processing
unknown
Evidence level
unknown
Business execution
unknown

Keep this fixed version · Original public source · Complete machine record

Published description

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

Inputs

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

Outputs

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

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "oauth",
    "notes": "Requires one of\u5B98\u65B9\u5217\u51FA\u7684 Drive OAuth scopes\uFF1B\u5305\u62EC metadata.readonly\u3001readonly\u3001file \u7B49\u4E0D\u540C\u8303\u56F4\uFF0C\u9700\u6309\u7528\u9014\u548C\u5B9E\u9645\u6388\u6743\u9009\u62E9\uFF0C\u90E8\u5206\u53D7\u9650 scope \u9700\u5B89\u5168\u8BC4\u4F30\u3002"
  },
  "command": null,
  "entry_url": "https://www.googleapis.com/drive/v3/files",
  "kind": "http_api",
  "method": "GET",
  "requirements": [
    "\u5DF2\u914D\u7F6E Google OAuth \u5E94\u7528\u5E76\u83B7\u5F97\u9002\u5F53\u6388\u6743",
    "\u9009\u62E9\u6700\u5C0F\u9700\u8981\u7684 scope \u548C\u5B9E\u9645\u6587\u4EF6/\u5171\u4EAB\u76D8\u8303\u56F4",
    "\u8BF7\u6C42\u4F53\u4E3A\u7A7A\uFF0C\u6B63\u786E\u5904\u7406\u5206\u9875\u548C incompleteSearch"
  ]
}

Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.

Third-party pricing and data handling

{
  "model": "unknown",
  "notes": "\u672C\u65B9\u6CD5\u53C2\u8003\u9875\u672A\u7ED9\u5F53\u524D\u8D26\u6237\u4EF7\u683C\u3001\u514D\u8D39\u989D\u5EA6\u6216\u6570\u503C\u901F\u7387\u9650\u5236\uFF1B\u4E0D\u628A\u53EA\u8BFB\u6216 Google \u5B98\u65B9\u63A5\u53E3\u89C6\u4E3A\u65E0\u9650\u514D\u8D39\u3002",
  "source_url": null
}
{
  "location": "provider_server",
  "notes": "\u67E5\u8BE2\u7531 Google Drive \u670D\u52A1\u5904\u7406\uFF0C\u8FD4\u56DE\u6388\u6743\u8303\u56F4\u5185\u7684\u6587\u4EF6\u8D44\u6E90\u4FE1\u606F\uFF1B\u5BA2\u6237\u7AEF/AI \u53EF\u80FD\u83B7\u5F97\u6587\u4EF6\u5143\u6570\u636E\u3002\u672C\u8F6E\u672A\u8BBF\u95EE\u8D26\u6237\uFF0C\u4FDD\u7559\u671F\u3001\u9A7B\u7559\u53CA\u6388\u6743\u4E3B\u4F53\u7684\u9690\u79C1\u8BBE\u7F6E\u672A\u77E5\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

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

Unknowns

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

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

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

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

Contributor-reported verification

{
  "checked_at": "2026-10-24T18:42:57.1561062\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://developers.google.com/workspace/drive/api/reference/rest/v3/files/list"
  ],
  "level": "documentation_only",
  "not_verified": [
    "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
  ],
  "outcome": "not_tested",
  "reported_by": "contributor",
  "software_version": null,
  "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}

Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.

Dynamic observations and corrections

null
null

Add a public correction or observation

Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.

Propose a sourced summary correction

This form proposes a summary change for the current fixed version. Other supported fields use the original API. Concurrent version changes return a conflict.

Report a conditional public observation

Complete fixed public record and original source fields

This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.

{
  "author_name": null,
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u67E5\u8BE2\u7531 Google Drive \u670D\u52A1\u5904\u7406\uFF0C\u8FD4\u56DE\u6388\u6743\u8303\u56F4\u5185\u7684\u6587\u4EF6\u8D44\u6E90\u4FE1\u606F\uFF1B\u5BA2\u6237\u7AEF/AI \u53EF\u80FD\u83B7\u5F97\u6587\u4EF6\u5143\u6570\u636E\u3002\u672C\u8F6E\u672A\u8BBF\u95EE\u8D26\u6237\uFF0C\u4FDD\u7559\u671F\u3001\u9A7B\u7559\u53CA\u6388\u6743\u4E3B\u4F53\u7684\u9690\u79C1\u8BBE\u7F6E\u672A\u77E5\u3002"
  },
  "description": "\u63A5\u53E3\u4E3A https://www.googleapis.com/drive/v3/files\u3002\u8BF7\u6C42\u4F53\u5E94\u4E3A\u7A7A\uFF1Bq \u53EF\u7EC4\u5408\u641C\u7D22\u6761\u4EF6\uFF0C\u9ED8\u8BA4\u53EF\u80FD\u5305\u542B\u56DE\u6536\u7AD9\u6587\u4EF6\uFF0C\u6392\u9664\u65F6\u9700\u4F7F\u7528 trashed=false \u7B5B\u9009\u3002pageToken \u8DDF\u968F\u524D\u4E00\u9875 nextPageToken\uFF1Bfiles \u6570\u7EC4\u53EF\u80FD\u4E0D\u5B8C\u6574\u3002incompleteSearch=true \u8FD8\u8868\u793A\u90E8\u5206\u8BED\u6599\u672A\u88AB\u641C\u7D22\uFF0C\u5C24\u5176 allDrives \u65F6\u53EF\u7F29\u5C0F corpora\u3002\u5F53\u524D\u6B63\u6587 pageSize \u4E0A\u9650\u4E3A 1000\uFF0C\u670D\u52A1\u4E5F\u53EF\u8FD4\u56DE\u8F83\u5C11\u9879\u76EE\u3002\u8BE5\u65B9\u6CD5\u4E0D\u63D0\u4F9B\u65E0\u6388\u6743\u516C\u5171\u7F51\u76D8\u6293\u53D6\u6216\u6587\u4EF6\u5185\u5BB9\u4E0B\u8F7D\u3002",
  "inputs": [
    "\u6709\u6548 Google OAuth \u6388\u6743\u53CA\u9002\u5408\u7528\u9014\u7684 scope",
    "\u53EF\u9009 q\u3001orderBy\u3001corpora\u3001driveId \u548C spaces",
    "\u5B9E\u9645\u8FD4\u56DE\u7684 nextPageToken \u4EE5\u53CA\u5171\u4EAB\u76D8\u652F\u6301\u53C2\u6570"
  ],
  "invocation": {
    "authentication": {
      "kind": "oauth",
      "notes": "Requires one of\u5B98\u65B9\u5217\u51FA\u7684 Drive OAuth scopes\uFF1B\u5305\u62EC metadata.readonly\u3001readonly\u3001file \u7B49\u4E0D\u540C\u8303\u56F4\uFF0C\u9700\u6309\u7528\u9014\u548C\u5B9E\u9645\u6388\u6743\u9009\u62E9\uFF0C\u90E8\u5206\u53D7\u9650 scope \u9700\u5B89\u5168\u8BC4\u4F30\u3002"
    },
    "command": null,
    "entry_url": "https://www.googleapis.com/drive/v3/files",
    "kind": "http_api",
    "method": "GET",
    "requirements": [
      "\u5DF2\u914D\u7F6E Google OAuth \u5E94\u7528\u5E76\u83B7\u5F97\u9002\u5F53\u6388\u6743",
      "\u9009\u62E9\u6700\u5C0F\u9700\u8981\u7684 scope \u548C\u5B9E\u9645\u6587\u4EF6/\u5171\u4EAB\u76D8\u8303\u56F4",
      "\u8BF7\u6C42\u4F53\u4E3A\u7A7A\uFF0C\u6B63\u786E\u5904\u7406\u5206\u9875\u548C incompleteSearch"
    ]
  },
  "limitations": [
    "\u672A\u767B\u5F55\u3001\u6388\u6743\u3001\u5217\u76EE\u5F55\u3001\u4E0B\u8F7D\u6587\u4EF6\u6216\u4FEE\u6539\u4EFB\u4F55 Drive \u6570\u636E\u3002",
    "\u9700 OAuth scope\uFF0C\u5217\u51FA\u7684 scope \u9009\u62E9\u4E0D\u540C\u4F1A\u5F71\u54CD\u53EF\u8BBF\u95EE\u8303\u56F4\uFF1B\u4E0D\u9ED8\u8BA4\u7533\u8BF7\u5E7F\u6CDB drive \u6743\u9650\u3002",
    "\u8FD4\u56DE\u5217\u8868\u4E0D\u7B49\u4E8E\u6587\u4EF6\u6B63\u6587\u6216\u5168\u90E8\u8D26\u6237\u6587\u4EF6\uFF1B\u6709 nextPageToken \u65F6\u9700\u7EE7\u7EED\uFF0CincompleteSearch=true \u65F6\u53EF\u80FD\u4ECD\u7F3A\u7ED3\u679C\u3002",
    "\u5206\u9875 token \u901A\u5E38\u4EC5\u6570\u5C0F\u65F6\u6709\u6548\uFF1B\u5931\u6548\u9700\u4ECE\u9996\u8BF7\u6C42\u91CD\u65B0\u5F00\u59CB\uFF0C\u671F\u95F4\u6587\u4EF6\u589E\u5220\u53EF\u6539\u53D8\u7ED3\u679C\u3002",
    "q \u9ED8\u8BA4\u53EF\u80FD\u5305\u542B\u56DE\u6536\u7AD9\u6587\u4EF6\uFF1B\u4E0D\u5E94\u5C06\u56DE\u6536\u7AD9\u9879\u76EE\u5F53\u4F5C\u666E\u901A\u5F53\u524D\u6587\u4EF6\u3002",
    "\u5171\u4EAB\u76D8\u53C2\u6570\u4E0E corpora \u5E94\u6309\u5B9E\u9645\u76EE\u6807\u8BBE\u7F6E\uFF1B\u4E0D\u80FD\u628A allDrives \u5F53\u4F5C\u6240\u6709\u5185\u5BB9\u4E00\u5B9A\u5B8C\u6574\u68C0\u7D22\u7684\u4FDD\u8BC1\u3002",
    "\u90E8\u5206 OAuth scope \u4E3A restricted\uFF0C\u5E94\u7528\u53EF\u80FD\u9700\u8981\u5B89\u5168\u8BC4\u4F30\u3002"
  ],
  "outputs": [
    "files[] \u6587\u4EF6\u8D44\u6E90\u5217\u8868",
    "nextPageToken\u3001kind \u548C incompleteSearch \u7B49\u5206\u9875/\u5B8C\u6574\u6027\u4FE1\u606F\uFF0C\u672A\u5B9E\u9645\u83B7\u53D6"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u672C\u65B9\u6CD5\u53C2\u8003\u9875\u672A\u7ED9\u5F53\u524D\u8D26\u6237\u4EF7\u683C\u3001\u514D\u8D39\u989D\u5EA6\u6216\u6570\u503C\u901F\u7387\u9650\u5236\uFF1B\u4E0D\u628A\u53EA\u8BFB\u6216 Google \u5B98\u65B9\u63A5\u53E3\u89C6\u4E3A\u65E0\u9650\u514D\u8D39\u3002",
    "source_url": null
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "public_record",
      "checked_at": "2026-10-24T18:42:57.1561062\u002B00:00",
      "title": "Method: files.list \u00A0|\u00A0 Google Drive \u00A0|\u00A0 Google for Developers",
      "url": "https://developers.google.com/workspace/drive/api/reference/rest/v3/files/list"
    }
  ],
  "summary": "\u5B98\u65B9 files.list \u4EE5 GET \u67E5\u8BE2\u83B7\u6388\u6743\u8303\u56F4\u5185\u7684 Drive \u6587\u4EF6\u8D44\u6E90\uFF0C\u652F\u6301 q\u3001\u6392\u5E8F\u3001\u5171\u4EAB\u76D8\u548C\u5206\u9875\uFF0C\u9700\u76F8\u5E94 OAuth scope\u3002\u6CA1\u6709\u8BBF\u95EE\u8D26\u6237\u6216\u5217\u51FA\u6587\u4EF6\uFF1B\u5217\u8868\u54CD\u5E94\u4E0D\u4EE3\u8868\u5DF2\u8BFB\u53D6\u6587\u4EF6\u6B63\u6587\u3002",
  "tags": [
    "Google Drive",
    "OAuth",
    "\u6587\u4EF6\u5143\u6570\u636E",
    "\u5206\u9875",
    "REST API"
  ],
  "terms_url": null,
  "title": "Google Drive API V3 \u2014 \u6587\u4EF6\u5217\u8868\u4E0E\u7B5B\u9009",
  "unknowns": [
    "\u5B9E\u9645\u8D26\u6237\u6388\u6743\u3001\u5E94\u7528 scope \u5BA1\u6279\u3001\u914D\u989D\u53CA\u53EF\u7528\u6027\u672A\u6838\u5B9E\u3002",
    "\u6587\u4EF6\u8D44\u6E90\u5B9E\u9645\u5B57\u6BB5\u3001\u5185\u5BB9\u53EF\u8BFB\u6027\u53CA\u5206\u9875\u5B8C\u6574\u6027\u672A\u6D4B\u8BD5\u3002",
    "V3 \u662F API \u8DEF\u5F84\u7248\u672C\uFF0C\u4E0D\u662F\u5B89\u88C5\u7248\u672C\u6216\u5DF2\u5B8C\u6210\u7684\u7F51\u76D8\u5DE5\u4F5C\u6D41\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T18:42:57.1561062\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://developers.google.com/workspace/drive/api/reference/rest/v3/files/list"
    ],
    "level": "documentation_only",
    "not_verified": [
      "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
    ],
    "outcome": "not_tested",
    "reported_by": "contributor",
    "software_version": null,
    "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
  },
  "schema_version": "navonavo.capability.v1",
  "service_id": "cap-d0c109fabcd5aed72d6f6980",
  "version": 2,
  "source_url": "https://developers.google.com/workspace/drive/api/reference/rest/v3/files/list",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "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"
    ]
  },
  "created_at": "2026-10-24T18:43:00.7826147\u002B00:00",
  "updated_at": "2026-10-24T18:43:48.5907684\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-d0c109fabcd5aed72d6f6980?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-d0c109fabcd5aed72d6f6980?version=2",
  "verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
  "library_material": {
    "organization": "organized",
    "semantic_state": "classified",
    "semantic_category": "\u6388\u6743\u4E91\u76D8\u6587\u4EF6\u5217\u8868 API",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-4f4e3c650ff54ba87ab0559ee82bd87b",
        "source_url": "https://developers.google.com/workspace/drive/api/reference/rest/v3/files/list",
        "content_sha256": "e4a2cca0302587400add635dfc6bf7cc48c12ec2022ba0b7409437eaaf30370f",
        "decoded_bytes": 302664,
        "content_type": "text/html",
        "captured_at": "2026-10-24T18:42:57.1561062\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "e4a2cca0302587400add635dfc6bf7cc48c12ec2022ba0b7409437eaaf30370f",
        "text_utf8_bytes": 302664,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-d0c109fabcd5aed72d6f6980/materials/material-4f4e3c650ff54ba87ab0559ee82bd87b?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-f9e96a70829347a98a2e6b60454e050b",
    "reason": "\u4EC5\u4F9D\u636E\u672C\u6B21\u5DF2\u4FDD\u5B58\u5B98\u65B9\u516C\u5F00\u6B63\u6587\u6574\u7406\u7528\u9014\u3001\u5165\u53E3\u3001\u6761\u4EF6\u548C\u672A\u77E5\u9879\uFF1B\u4FDD\u7559\u539F\u6587\u8BC1\u636E\uFF0C\u4E0D\u5C06\u8BF4\u660E\u6587\u6863\u5192\u5145\u5B9E\u9645\u63A5\u901A\u3001\u529F\u80FD\u5B9E\u6D4B\u6216\u53EF\u7528\u6027\u4FDD\u8BC1\u3002",
    "source_urls": [
      "https://developers.google.com/workspace/drive/api/reference/rest/v3/files/list"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-d0c109fabcd5aed72d6f6980",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-d0c109fabcd5aed72d6f6980?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-d0c109fabcd5aed72d6f6980?version=2",
    "profiles": [],
    "warnings": [
      "\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
      "\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
    ]
  }
}

Submit another public source · Privacy and disclosure

Copy for your AI

Copy this text manually if clipboard access is unavailable. Copying does not register, install or connect anything.