name: gws-people
description: 'Google People: 管理联系人和个人资料。'
metadata:
    version: 0.22.5
    openclaw:
        category: "productivity"
        requires:
            bins:
                - gws
        cliHelp: "gws people --help"

people (v1)

先决条件： 阅读 ../gws-shared/SKILL.md 了解认证、全局标志和安全规则。如果缺失，运行 gws generate-skills 创建。

gws people <resource> <method> [flags]

API 资源

contactGroups

• batchGet — 通过指定联系人组资源名称列表，获取认证用户拥有的联系人组列表。
• create — 为认证用户创建一个新的联系人组。创建的联系人组名称必须与用户的联系人组名称唯一。尝试创建重复名称的组将返回 HTTP 409 错误。同一用户的变更请求应顺序发送，以避免增加延迟和失败。
• delete — 通过指定联系人组资源名称，删除认证用户拥有的现有联系人组。同一用户的变更请求应顺序发送，以避免增加延迟和失败。
• get — 通过指定联系人组资源名称，获取认证用户拥有的特定联系人组。
• list — 列出认证用户拥有的所有联系人组。不填充联系人组的成员。
• update — 更新认证用户拥有的现有联系人组名称。更新后的联系人组名称必须与用户的联系人组名称唯一。尝试创建重复名称的组将返回 HTTP 409 错误。同一用户的变更请求应顺序发送，以避免增加延迟和失败。
• members — 对 'members' 资源的操作

otherContacts

• copyOtherContactToMyContactsGroup — 将“其他联系人”复制到用户“myContacts”组中的新联系人。同一用户的变更请求应顺序发送，以避免增加延迟和失败。
• list — 列出所有“其他联系人”，即不在联系人组中的联系人。“其他联系人”通常是交互中自动创建的联系人。同步令牌在全量同步 7 天后过期。使用过期同步令牌的请求将收到包含原因“EXPIRED_SYNC_TOKEN”的 google.rpc.ErrorInfo 错误。遇到此类错误时，客户端应发出不带 sync_token 的全量同步请求。
• search — 提供与搜索查询匹配的认证用户其他联系人列表。查询匹配来自 OTHER_CONTACT 来源的联系人的 names、emailAddresses 和 phoneNumbers 字段。重要提示： 搜索前，客户端应发送一个空查询的预热请求以更新缓存。参见 https://developers.google.com/people/v1/other-contacts#search_the_users_other_contacts

people

• batchCreateContacts — 批量创建新联系人，并为新创建的联系人返回 PersonResponses。同一用户的变更请求应顺序发送，以避免增加延迟和失败。
• batchUpdateContacts — 批量更新联系人，并返回资源名称到更新后联系人的 PersonResponses 映射。同一用户的变更请求应顺序发送，以避免增加延迟和失败。
• createContact — 创建一个新联系人，并返回该联系人的人脉资源。如果某个单例字段为联系人来源指定了不止一个字段，请求将返回 400 错误：* biographies * birthdays * genders * names。同一用户的变更请求应顺序发送，以避免增加延迟和失败。
• deleteContactPhoto — 删除联系人的照片。同一用户的变更请求应顺序执行，以避免锁竞争。
• get — 通过指定资源名称提供某人的信息。使用 people/me 表示认证用户。如果未指定 'personFields'，请求将返回 400 错误。
• getBatchGet — 通过指定请求的资源名称列表提供多个人的信息。使用 people/me 表示认证用户。如果未指定 'personFields'，请求将返回 400 错误。
• listDirectoryPeople — 提供认证用户域目录中的域个人资料和域联系人列表。当指定了 sync_token 时，自上次同步以来删除的资源将以 PersonMetadata.deleted 设置为 true 的人脉形式返回。当指定了 page_token 或 sync_token 时，所有其他请求参数必须与第一次调用匹配。写操作对同步请求可能有几分钟的传播延迟。增量同步不适用于先写后读的使用场景。
• searchContacts — 提供与搜索查询匹配的认证用户分组联系人列表。查询匹配来自 CONTACT 来源的联系人的 names、nickNames、emailAddresses、phoneNumbers 和 organizations 字段。重要提示： 搜索前，客户端应发送一个空查询的预热请求以更新缓存。参见 https://developers.google.com/people/v1/contacts#search_the_users_contacts
• searchDirectoryPeople — 提供与搜索查询匹配的认证用户域目录中的域个人资料和域联系人列表。
• updateContact — 更新现有联系人的联系人数据。任何非联系人数据将不会被修改。要更新的人脉中的任何非联系人数据将被忽略。在 update_mask 中指定的所有字段将被替换。如果未为要更新的联系人指定 person.metadata.sources 或没有联系人来源，服务器返回 400 错误。
• updateContactPhoto — 更新联系人的照片。同一用户的变更请求应顺序发送，以避免增加延迟和失败。
• connections — 对 'connections' 资源的操作

发现命令

在调用任何 API 方法之前，检查它：

# 浏览资源和方法
gws people --help

# 检查方法的必需参数、类型和默认值
gws schema people.<resource>.<method>

使用 gws schema 的输出构建你的 --params 和 --json 标志。