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 天过期。使用过期同步令牌的请求将返回一个带有 google.rpc.ErrorInfo 且 reason 为 “EXPIRED_SYNC_TOKEN” 的错误。在这种情况下，客户端应执行不带 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 — 创建新联系人，并返回该联系人的 person 资源。如果对于联系人来源中的单例字段指定了多个字段，则请求返回 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 — 更新现有联系人的联系人数据。任何非联系人数据不会被修改。要更新的 person 中的任何非联系人数据将被忽略。update_mask 中指定的所有字段都将被替换。如果未指定要更新的联系人的 person.metadata.sources 或没有联系人来源，服务器将返回 400 错误。
• updateContactPhoto — 更新联系人的照片。同一用户的变更请求应顺序发送，以避免增加延迟和失败。
• connections — 对“connections”资源的操作

发现命令

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

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

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

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