Gws People

核心功能

gws-people 是 Google People API 的命令行封装工具，提供完整的通讯录管理功能：

• 群组管理：创建、删除、更新、查询联系人群组（contactGroups）
• 联系人操作：批量创建/更新联系人、单条增删改查、照片管理
• 其他联系人：管理自动生成的交互联系人，支持搜索和迁移
• 域目录集成：搜索企业域内用户和联系人

显著优点

• 原生API完整映射：覆盖 People API v1 全部核心能力，无功能阉割
• 批量操作支持：batchCreateContacts、batchUpdateContacts 提升效率
• 企业场景友好：listDirectoryPeople、searchDirectoryPeople 对接 Google Workspace 组织目录
• 标准CLI范式：统一的 gws <resource> <method> 命令结构，学习成本低

潜在局限

• 认证依赖：强制依赖 gws-shared 的 OAuth 配置，单点故障风险
• 无图形界面：纯命令行交互，不适合非技术用户
• 并发限制：文档明确要求"同一用户的变更请求需串行发送"，避免锁竞争
• 同步令牌过期：sync_token 7天过期，需全量同步兜底

适用人群

• Google Workspace 管理员批量操作用户通讯录
• 开发者构建联系人同步/迁移脚本
• 需要自动化管理"其他联系人"的进阶用户

安全风险提示

• OAuth 令牌需妥善保管，../gws-shared/SKILL.md 中应定义令牌存储规范
• 域目录搜索可能暴露组织成员信息，需注意数据可见性配置
• 联系人照片删除/更新操作不可逆，建议操作前备份

技术备注

版本 0.22.5，属于 gws 工具链的模块化组件，需配合 gws 主程序使用。