用途:gws-people 用于通过命令行管理 Google People(联系人)数据,属于 gws-claude-plugin 的 CLI 技能。
主要能力:按资源分为四类。contactGroups 支持批量获取、创建、删除、获取、列出和重命名联系人组,以及成员操作;otherContacts 支持列出、搜索,以及将其他联系人复制到 myContacts 组;people 支持批量创建与更新联系人、创建联系人、删除/更新联系人照片、获取个人或一批人信息、列出目录人员、按姓名/昵称/邮箱/电话/组织等搜索联系人、搜索目录人员、更新联系人;另含 connections 资源。
必要用法:先阅读 ../gws-shared/SKILL.md 了解认证、全局标志和安全规则,若缺失运行 gws generate-skills 生成。命令形式为 gws people <resource> <method> [flags]。调用前可用 gws people --help 浏览资源与方法,用 gws schema people.<resource>.<method> 查看必填参数、类型与默认值,据此构建 --params 与 --json。搜索联系人前建议先发空查询做预热。
限制:同一用户的变更请求应串行发送以避免延迟与失败;联系人组名称需唯一,重复会返回 HTTP 409;createContact 在单值字段(如 biographies、birthdays、genders、names)指定多个字段会返回 400;get 与 getBatchGet 未指定 personFields 会返回 400;updateContact 未指定 person.metadata.sources 或无联系人源会返回 400;同步令牌在完整同步后 7 天过期,过期需重新完整同步;目录增量同步不适合写入后立即读取,写操作可能有数分钟传播延迟。
适用场景:需要以脚本或命令行方式管理 Google 联系人、联系人组、其他联系人和域目录人员的场景。
认证方式、具体 flags、收费与价格信息暂未提供。