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-x-3/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我把上个月所有包含“项目报告”关键词的Gmail邮件标题和发件人导出到一个CSV文件。'，它会指导你使用类似 `gws gmail search "项目报告 after:2024-03-01" --format csv --output reports.csv` 的命令来完成。或者，当你说‘我需要批量修改Google Drive里某个文件夹下所有文件的共享权限，设置为仅限公司内部查看’，AI会建议使用 `gws drive share --folder-id <ID> --role reader --type domain --domain yourcompany.com` 这样的命令链来实现。
介绍
gws CLI 是一款专为 Google Workspace 设计的命令行工具，旨在解决开发者和管理员在终端中批量操作 Google 服务时遇到的 API 调用复杂、权限错误（如 403、invalid_grant）和配额限制等问题。它封装了超过 20 个 Google API，让你无需编写复杂脚本即可直接执行搜索邮件、发送批量邮件、上传/导出/共享文件、管理日历事件、用户和群组等操作。
使用时，你只需在终端配置好 OAuth 凭据，即可通过简洁的 gws 命令链式调用各种功能，例如批量搜索 Gmail 邮件并导出结果，或者自动化管理 Google Drive 文件的共享权限。它特别适合将重复的 Workspace 管理任务脚本化，或作为 MCP 工具暴露给其他 AI 助手使用。
该工具主要面向需要高效、自动化处理 Google Workspace 日常任务的后端开发、运维工程师和系统管理员。对于需要批量处理邮件、文件或用户数据的团队，它能显著提升工作效率。
需要注意的是，gws 专注于 Google Workspace 应用层（如 Gmail, Drive, Calendar）的自动化，而非 Google Cloud 基础设施（gcloud）。使用前需确保已拥有相应的 Google Workspace 管理员权限或 API 访问权限，并妥善保管 OAuth 客户端密钥。
核心特点
与通用的 Google API 客户端库不同，gws CLI 直接提供了开箱即用的高级命令，专门针对 Workspace 管理中的批量操作和错误处理（如 403、配额错误）进行了优化，并能将 Workspace 操作封装为 MCP 工具供其他 AI 调用。
注意事项
不适用于管理 Google Cloud 基础设施（应使用 gcloud）或操作本地的 macOS 邮件和日历应用。
常见问题
gws 和 gcloud 有什么区别？
gws 用于自动化 Google Workspace 应用（如 Gmail, Drive），而 gcloud 用于管理 Google Cloud 平台的基础设施（如虚拟机、数据库）。
出现 403 或 invalid_grant 错误怎么办？
这通常是 OAuth 凭据或 API 权限范围问题，请检查服务账号或 OAuth 客户端的权限配置是否正确，并确保已启用所需 API。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/google-workspace-cli-x-3/raw/index.md 读取 Google Workspace CLI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/google-workspace-cli-x-3/raw/index.md（查看排版版本）