Google Workspace CLI
通过命令行自动化管理Google Workspace的终端工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Google Workspace CLI。 它的用途是：通过命令行自动化管理Google Workspace的终端工具 完整的 Skill 内容见：https://321skill.com/skills/google-workspace-cli/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我在终端里用gws搜索所有包含“项目报告”关键词的Gmail邮件，并将结果导出为CSV文件。’，它会指导你运行类似 `gws gmail search 'subject:项目报告' --format csv --output reports.csv` 的命令，完成邮件的批量搜索与导出。或者，当你说‘我需要批量修改Google Drive里某个文件夹下所有文件的分享权限为仅限公司内部查看’，AI会建议使用 `gws drive share --folder-id <ID> --domain your-company.com` 命令来实现。
介绍
gws CLI是一个专为Google Workspace设计的命令行工具，旨在解决开发者和IT管理员在终端中直接、批量操作Google服务时遇到的难题。当您需要通过脚本自动化处理Gmail邮件、管理Drive文件、操作Calendar日程，或使用Admin SDK管理用户和群组时，API调用常因权限（如403错误）、配额或授权问题（如invalid_grant）而失败，手动操作又繁琐低效，gws CLI提供了稳定、便捷的替代方案。
它通过封装20多个Google API，提供了search、send、upload、export、share等一系列命令，让您无需编写复杂的OAuth流程或错误处理代码，即可在终端中执行批量邮件搜索与发送、文件共享与导出、事件与用户管理等操作。同时，它也支持将Workspace操作暴露为MCP工具，方便集成到更广泛的自动化工作流中。
该工具非常适合需要频繁、批量操作Google Workspace的后端开发、运维工程师、系统管理员以及自动化脚本开发者。对于需要将Google服务集成到内部工具或自动化流程中的团队，gws CLI能显著提升效率。
使用前请确保已正确配置Google Cloud项目和服务账号权限。请注意，它专注于Google Workspace（如Gmail, Drive, Calendar, Sheets, Docs, Admin SDK），不适用于管理Google Cloud基础设施（那是gcloud CLI的范畴）或操作本地的macOS邮件和日历应用。
核心特点
与通用的Google API客户端库或零散的脚本不同，gws CLI专门针对Google Workspace的日常运维和批量操作场景进行了深度封装和错误处理优化，能有效应对API调用中的403、invalid_grant等常见错误，并提供开箱即用的MCP工具集成能力。
注意事项
不适用于管理Google Cloud基础设施（如Compute Engine, GKE）或操作本地macOS邮件和日历应用。
常见问题
gws和gcloud有什么区别？
gws专注于Google Workspace（如Gmail, Drive, Calendar）的用户数据和资源管理；gcloud则用于管理Google Cloud Platform（如虚拟机、存储桶、Kubernetes集群）的基础设施。
出现403或invalid_grant错误怎么办？
gws CLI内置了针对这些常见API错误的优化处理机制，但仍需确保服务账号拥有正确的Workspace域范围权限且访问令牌有效。请按照文档检查OAuth范围和权限配置。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/google-workspace-cli/raw/index.md 读取 Google Workspace CLI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/google-workspace-cli/raw/index.md（查看排版版本）