SuperAPI AI 工具集

google-workspace

编程与开发

查看项目

更新于 10-15 23:31

技能介绍

用途:该技能用于构建与 Google Workspace API 的集成,涵盖 Gmail、Calendar、Drive、Sheets、Docs、Chat、Meet、Forms、Tasks、Admin SDK、People 等接口,并说明各自的常见使用场景(如邮件自动化、日程管理、文件存储与共享、表格报表、文档生成、聊天机器人、表单响应、任务管理、用户与群组管理等)。

主要能力:统一介绍所有 Workspace API 共用的认证方式,包括 OAuth 2.0 用户上下文(需 access_type=offline 与 prompt=consent 以获取刷新令牌,访问令牌约 1 小时过期)与服务账号(服务器到服务器,支持域范围委派模拟用户)。同时给出配额与限流参考(如 Gmail、Calendar、Drive、Sheets 的按用户与按项目限制),以及 429/503/403 rateLimitExceeded 的指数退避重试方法,并说明批量请求(通常单批最多 100 个请求,部分 API 如 Drive 可达 1000 个,每个请求均计入配额)。

使用方式:依赖 Cloudflare Workers(推荐)与 Google Cloud 项目。通过 wrangler 配置 kv_namespaces 或 d1_databases 存储令牌,并用 npx wrangler secret put 设置 GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET,服务账号可用 cat service-account.json | npx wrangler secret put GOOGLE_SERVICE_ACCOUNT。各 API 的详细模式见 references/ 目录下的 gmail-api.md 等文件,使用特定 API 时按需加载。

限制与说明:文档标注的限流数值为近似值,应查阅各 API 具体限制;常见错误包括 invalid_grant(刷新令牌被撤销或过期)、access_denied(应用未验证)、insufficientPermissions、rateLimitExceeded、notFound 等,并给出对应修复方向。部分 API(Docs、Meet、Forms、Tasks、Admin SDK、People)在文中仅列为路线图或参考文件,具体细节暂未提供。资料中还包含作者自述的 package 版本与官方文档链接,未提供收费、价格或效果类信息。