← 所有 API
Drive API logo

Drive API

Drive API

正常免费analyticsGoogle

Google Drive API 提供文件存储、共享、搜索能力，是文档协作类集成的基础。

访问站点 ↗健康巡检 9 小时前
适合什么时候用

配额慷慨，按用户独立计算

先注意什么

大文件上传需走 resumable upload 协议

第一步先查

在 console.cloud.google.com 启用 Drive API 并配 OAuth。用户授权后调 files.list、files.create 等接口。常用 scope 包括 drive.file（只能访问应用创建的文件，更安全）和 drive（全部文件）。

认证
oauth
CORS
不支持
HTTPS
是
注册
需要
延迟
44 ms
协议
REST
计费
free

可用率 · 30 天窗口

巡检: 1可用率: 100%平均延迟: 44ms
01

关于这个 API

Google Drive API 把 Drive 服务暴露为 REST 接口，覆盖文件 CRUD、文件夹组织、权限共享、搜索、变更监听等能力。它和 Google Docs/Sheets/Slides API 配合，使应用能编程创建并编辑 Google 原生文档。

上传分简单上传（< 5MB）、multipart 上传（一次请求带 metadata + 数据）、resumable 上传（大文件、断点续传）。生产环境建议默认用 resumable，可应对网络抖动。权限模型基于 permissions 资源：可以给单个邮箱、Workspace 域、anyone with the link 等多种主体授权。建议优先用 drive.file scope 而非全权 drive scope——前者用户授权时不会出现"访问全部文件"的警告，更易通过 verification。

02

你可以做什么

  • 1为应用提供"用 Google Drive 保存"功能
  • 2把 Drive 当 headless 文件库给前端取
  • 3批量整理或迁移文档与权限
  • 4将外部文件同步到 Google Docs 编辑
  • 5基于变更监听做自动化（如新文件触发分析）
03

优劣对比

优点

  • 配额慷慨，按用户独立计算
  • 统一管理 Drive、Docs、Sheets、Slides 文件
  • 支持文件版本历史与恢复
  • permissions API 让 ACL 程序化管理

注意事项

  • 大文件上传需走 resumable upload 协议
  • 某些操作有秒级速率限制，批量任务需 backoff
  • 中国大陆访问 googleapis.com 受限
04

示例请求

通用模板 — 实际 endpoint 请查阅文档替换 <endpoint>。
curl https://google.com/<endpoint> \
  -H "Authorization: Bearer $ACCESS_TOKEN"
05

快速开始

在 console.cloud.google.com 启用 Drive API 并配 OAuth。用户授权后调 files.list、files.create 等接口。常用 scope 包括 drive.file（只能访问应用创建的文件，更安全）和 drive（全部文件）。

06

常见问题

API 调用是否计费？+

免费使用，配额按 quota units 计；每用户每天 10 亿 units，对常规应用富余。

drive 和 drive.file 两个 scope 怎么选？+

只操作应用自创的文件选 drive.file，更安全且易通过 verification；需读所有文件才用 drive。

上传大文件总是失败？+

改用 resumable upload 协议——把文件切块，逐块上传可中断续传，减少超时与抖动影响。

可以监听某个文件的变更吗？+

可以用 files.watch 注册 webhook，或对整个用户 Drive 用 changes.watch 监听全局变更。

07

技术细节

CORS: NoHTTPS: Yes注册: Yes开源: No
认证方式
oauth
计费
free
协议
REST
SDK
python, javascript, java, go, ruby
响应时间
44 ms
上次巡检
2026/5/12 07:37:31
08

接口端点

从 OpenAPI spec 自动解析。显示 12 / 48 个未弃用端点。

GET
/aboutabout
GET
/changeschanges
pageToken:query*driveId:queryincludeCorpusRemovals:queryincludeItemsFromAllDrives:queryincludeLabels:query+9 更多
GET
/changes/startPageTokenchanges
driveId:querysupportsAllDrives:querysupportsTeamDrives:queryteamDriveId:query
POST
/changes/watchchanges
pageToken:query*driveId:queryincludeCorpusRemovals:queryincludeItemsFromAllDrives:queryincludeLabels:query+9 更多
POST
/channels/stopchannels
GET
/drivesdrives
pageSize:querypageToken:queryq:queryuseDomainAdminAccess:query
POST
/drivesdrives
requestId:query*
DELETE
/drives/{driveId}drives
driveId:path*allowItemDeletion:queryuseDomainAdminAccess:query
GET
/drives/{driveId}drives
driveId:path*useDomainAdminAccess:query
PATCH
/drives/{driveId}drives
driveId:path*useDomainAdminAccess:query
POST
/drives/{driveId}/hidedrives
driveId:path*
POST
/drives/{driveId}/unhidedrives
driveId:path*

另有 36 个端点未显示，详见 OpenAPI spec。

09

标签

storagedocumentsgoogle-workspaceoauthrest
10

更多来自 Google 的 API

查看 Google 全部 API →
Admin SDK API

Google Workspace Admin SDK API 程序化管理 Workspace 组织：用户、组、设备、域名、审计日志、组织单元。

AdMob API

AdMob API 可读取 accounts、apps、adUnits 与 adSources，并生成 mediation 与 network 报表。

AdSense Host API

AdSense Host API 支持 accounts、adclients、adunits、reports 和 adcode 生成，适合托管式广告平台集成。

Apigee API

Apigee API 可管理 API proxy、deployments、attributes 与 organizations，适合把 API 网关运维接入自动化流程。

BigQuery API

Google BigQuery API 是 GCP 旗舰数据仓库的 REST 接口：执行 SQL 查询、管理 datasets/tables、流式插入、ML 内置。

Binary Authorization API

Binary Authorization API 用于管理 attestors、IAM policy 与镜像验证流程，面向 GKE 和 Anthos 的发布门禁。

Business Profile Performance API

Business Profile Performance API 能拉取 location 指标时间序列和 search keyword impressions，服务 Google 商家资料分析。

Calendar API

Google Calendar API 让应用程序化创建、读取、更新日历事件，是日程类应用最常用的集成。