用途:通过命令行调用 Google People API(v1),管理已认证用户的联系人、联系人分组和个人资料。
主要能力:contactGroups 资源支持 batchGet、create、delete、get、list、update 及 members 子资源操作;otherContacts 支持 copyOtherContactToMyContactsGroup、list、search;people 资源支持 batchCreateContacts、batchDeleteContacts、batchUpdateContacts、createContact、deleteContact、deleteContactPhoto、get、getBatchGet、listDirectoryPeople、searchContacts、searchDirectoryPeople、updateContact、updateContactPhoto,以及 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;get 与 getBatchGet 未指定 personFields 返回 400;createContact 对 biographies、birthdays、genders、names 等单例字段指定多个会返回 400;updateContact 需指定 person.metadata.sources 且无联系人来源时返回 400;otherContacts 同步令牌在完整同步后 7 天过期,过期需不带 sync_token 重新完整同步;搜索前应先发送空查询预热请求更新缓存;listDirectoryPeople 增量同步不适用于写后读场景,写入可能有数分钟传播延迟。认证与安全细节以 gws-shared 为准,资料未提供具体认证方式。