SuperAPI AI 工具集

gws-people

通用与其它

查看项目

更新于 10-16 05:49

技能介绍

用途:通过 gws 命令行调用 Google People API(v1),管理已认证用户的联系人、联系人群组及个人资料。需先阅读 ../gws-shared/SKILL.md 了解认证、全局标志和安全规则;缺失时运行 gws generate-skills 生成。

基本用法:gws people <resource> <method> [flags]。可先用 gws people --help 浏览资源与方法,用 gws schema people.<resource>.<method> 查看所需参数、类型与默认值,据此构造 --params 和 --json。

主要资源与方法:contactGroups 支持 batchGet、create、delete、get、list、update 及 members 子资源操作;otherContacts 支持 list、search 和 copyOtherContactToMyContactsGroup;people 支持 batchCreateContacts、batchUpdateContacts、createContact、deleteContactPhoto、get、getBatchGet、listDirectoryPeople、searchContacts、searchDirectoryPeople、updateContact、updateContactPhoto,以及 connections 子资源。

使用要点:get 等方法需指定 personFields,否则返回 400;people/me 表示已认证用户。同一用户的变更请求应顺序发送。群组名需唯一,重名返回 HTTP 409。搜索联系人前应先发送空查询的 warmup 请求更新缓存。otherContacts 的同步令牌在完整同步后 7 天过期,过期需重新完整同步。

适用场景:在命令行或自动化脚本中批量维护联系人、查找通讯录、同步目录人员等。限制:资料未提供收费、价格、平台支持与具体效果信息。