开放能力导航
首页/文档与知识管理/Google 文档与文件 API
文档与知识管理 / Google Workspace · Drive / Docs / Sheets

Google 文档与文件 API

以 Drive、Docs 和 Sheets 三套 API 连接文件管理、文档编辑和表格数据处理，适合自动生成文档、报表与文件协作工具。此条目固定覆盖这三项 API，接入时仍需分别启用服务、选择权限和核对配额。

Google DriveGoogle DocsGoogle Sheets文件管理文档生成电子表格
01 / CAPABILITIES

开放功能

核心接口调用手册

4 个场景

覆盖用户 OAuth 获取与刷新令牌、Drive 文件列表、Docs 新建并插入正文、Sheets 读写值。示例面向个人授权，不含组织级委派、服务账号或任意文件访问。

获取与刷新 Google 用户令牌列出可访问的 Drive 文件创建 Docs 文档并写入正文读取并更新 Sheets 单元格

文件上传与格式导出

将文件上传至 Drive，并把支持的 Google 原生文档或表格导出为对应格式。

接入要求按场景选择上传方式；导出格式依文件类型而异，导出不等于能无损恢复原文档的全部结构。
Drive 文件上传流程Google 文档与表格导出格式
02 / REQUIREMENTS

接入条件

适用主体
文档与报表工具开发者、文件协作应用开发者、Workspace 自动化开发者
接入方式
终端用户 OAuth 2.0 授权 / 具备相应资源权限的服务账号 / 组织级代用需 Workspace 超级管理员启用域级委派
申请概况
需 Google Cloud 项目与目标文件权限；用户 OAuth 和服务账号场景分别配置。
  • 建立 Google Cloud 项目并分别启用 Drive、Docs、Sheets 中实际使用的 API，再创建相应凭证。
  • 处理个人文件通常通过用户 OAuth；配置同意屏幕、回调地址、scopes 和开发测试用户。
  • 优先选择 drive.file 等符合需求的窄权限；公开应用使用敏感或受限 scopes 时，需完成适用的验证，部分受限数据处理还要求安全评估。
  • 服务账号是独立身份，不会自动取得用户云盘权限；要代表 Workspace 用户执行组织级任务，需要超级管理员授权的域级委派。
  • 用户授权、文件实际角色和组织策略都需要满足；不要把申请了 scope 理解为绕过文件访问控制。
创建 Cloud 项目与启用 Workspace API用户、服务账号与组织级委派OAuth 同意屏幕、测试用户与 scopesDrive 逐文件权限与敏感、受限 scopesSheets 授权范围与文件粒度Drive 文件、文件夹与共享盘权限
03 / GET STARTED

开通步骤

  1. 01

    创建项目并启用 API

    进入 Google Cloud console，为当前工具建立项目，只启用实际使用的文档、表格或文件服务。

  2. 02

    选择身份与授权范围

    个人和多用户工具先设计 OAuth；组织自动化再核对服务账号及管理员委派，选择最小 scopes。

  3. 03

    准备测试用户与文件

    按同意屏幕配置添加允许的测试用户，使用自己控制的测试文件，确认文件和工作区权限。

  4. 04

    分别验证三套接口

    从文件查询、文档读取或单元格读取开始，再验证创建、编辑和导出；记录各 API 配额与错误响应。

04 / COSTS & LIMITS

费用、边界与测试方式

费用概况

当前标准 API 使用无额外费用，超配额收费仍需核对 Google 的后续公告与项目账单。

  • 截至 2026-10-15，Drive、Docs、Sheets 各自用量页均说明标准使用无额外费用，并分别设置请求配额。
  • Docs、Sheets 按读写请求及项目、用户等维度管理配额；Drive 使用自己的配额规则，不能把三项预算合并成一项无限额度。
  • 三项页面均预告 2026 年后续对超配额请求收取 Cloud 账单费用；统一调整页提到标准日阈值和提前通知机制，不能将计划直接写成已全面生效。
  • Google Workspace 用户订阅、Drive 存储以及应用部署消耗的其他 Cloud 资源不因 API 标准用量无额外费而一并免费。
  • 本页不列尚未在所读资料中确定的超额单价；请求提高配额也不意味着一定获得批准。
Drive API 配额与费用Docs API 配额与费用Sheets API 配额与费用Workspace 2026 配额与计费调整计划

使用范围与限制

  • Drive、Docs 和 Sheets 是不同服务；一个 API 的开通、配额或文件操作成功不能证明另外两个已经接入。
  • 此条目不包括 Gmail、Calendar、Meet、Admin 等其他 Workspace API，也不代表已获得组织全部数据的管理权。
  • 公开应用的 OAuth 发布、敏感范围验证与组织管理员授权不同，测试用户可用不等于已可向所有用户分发。
  • Sheets 文件级授权不能变成单工作表级授权；表格保护范围也不能替代 OAuth 和文件权限。
  • 各 API 有项目及用户维度的配额、负载和处理限制；遇到限流时按对应文档退避，不套用统一请求次数。
  • 标准使用费用与文件存储、Workspace 席位及自己使用的 Cloud 资源费用分开；官方计费调整计划需在接入前复核。

如何进行开发测试

  • 正式服务：三套 API 操作实际获得授权的文件、文档和电子表格。
  • OAuth 测试模式：按官方配置允许的测试用户，用于验证授权；它不是文件数据隔离环境。
  • 开发验证：建议使用独立 Cloud 项目和测试文件，分别检查读取、写入、授权撤销和限流行为。
  • 本次未创建项目、授权账号或运行请求，也未确认覆盖三套 API 的统一数据沙箱。

接入前再确认

  • 以文档与文件场景合并展示三套 API，实际认证、方法与配额仍分别核对。
  • 未确认用户所在地区、账号类型及组织管理策略下的实际可用性；未创建项目或索取用户授权。
  • 费用页仍使用后续计划措辞，因此保留当前标准用量和未来超额规则之间的时间边界。
05 / OFFICIAL SOURCES

官方资料

以下资料用于核对本页内容。申请与使用时，请以对应接口的最新规则为准。

  1. 01
    Google Drive API 能力概览已核对官方资料 · 2026-10-15
  2. 02
    Google Docs API 能力概览已核对官方资料 · 2026-10-15
  3. 03
    Google Sheets API 能力概览已核对官方资料 · 2026-10-15
  4. 04
    Drive 文件上传流程已核对官方资料 · 2026-10-15
  5. 05
    Google 文档与表格导出格式已核对官方资料 · 2026-10-15
  6. 06
    Drive 文件、文件夹与共享盘权限已核对官方资料 · 2026-10-15
  7. 07
    创建 Cloud 项目与启用 Workspace API已核对官方资料 · 2026-10-15
  8. 08
    用户、服务账号与组织级委派已核对官方资料 · 2026-10-15
  9. 09
    OAuth 同意屏幕、测试用户与 scopes已核对官方资料 · 2026-10-15
  10. 10
    Drive 逐文件权限与敏感、受限 scopes已核对官方资料 · 2026-10-15
  11. 11
    Sheets 授权范围与文件粒度已核对官方资料 · 2026-10-15
  12. 12
    Drive API 配额与费用已核对官方资料 · 2026-10-15
  13. 13
    Docs API 配额与费用已核对官方资料 · 2026-10-15
  14. 14
    Sheets API 配额与费用已核对官方资料 · 2026-10-15
  15. 15
    Workspace 2026 配额与计费调整计划已核对官方资料 · 2026-10-15
  16. 16
    Google Cloud API 控制台入口官方入口 · 细则待复核 · 2026-10-15
官方文档核对，未进行接口实测
最近核验 2026-10-15 · 查看核验说明

其他平台

全部平台
Notion 数据 API文档与知识管理飞书办公协作企业微信办公协作