Google Workspace 办公集成

要解决什么问题

在 Agent 或自动化脚本里直接操作 Google 账号里的邮件、日程和文件，往往得自己拼 REST API、管 OAuth 刷新和各类服务的 endpoint。本技能把 Gmail、Calendar、Drive、Docs、Sheets（以及联系人等相关能力）收敛到统一入口，让模型通过 gws CLI 或 Python 调用，而不是每次从零写 HTTP 客户端。

技能如何工作

技能面向已配置 Google OAuth2 的环境：需要 google_client_secret.json（Cloud Console 下载的客户端凭据）和由 setup 脚本生成的 google_token.json（用户授权后的 token）。凭据就绪后，核心路径是：

• 用 gws 命令行完成常见读写（查邮件、改日历、列 Drive 文件等）
• 或在 Python 侧走同一套集成，便于和 Agent 工作流串在一起

元数据里与 himalaya 等邮件类技能并列，说明它更偏「Google 全家桶」而不是单一 IMAP 客户端；平台支持 Linux、macOS、Windows。

适用边界与注意点

• 功能边界以 SKILL 描述为准：Gmail / Calendar / Drive / Docs / Sheets，不要假设已覆盖 Google 全产品线（如 Meet、Admin SDK 等未在描述中声明的能力）。
• OAuth scope 与 Cloud Console 里启用的 API 必须一致；token 过期或撤销会导致调用失败，需要按 setup 流程重新授权。
• 涉及读写信件、改文档或删 Drive 文件时，Agent 应具备明确用户确认，避免误操作不可恢复的云端数据。