people（v1）

前提条件：请先阅读 ../gws-shared/SKILL.md，了解认证机制、全局标志（global flags）及安全规则。若该文件缺失，请运行 gws generate-skills 命令生成。

gws people   [flags]

API 资源

contactGroups

• batchGet — 通过指定一组 contact group 资源名称，获取由已认证用户拥有的 contact group 列表。
• create — 为已认证用户创建一个新的 contact group。所创建的 contact group 名称必须在该用户的 contact group 中唯一；若尝试创建同名 group，将返回 HTTP 409 错误。针对同一用户的变更请求（mutate requests）应按顺序发送，以避免延迟增加和失败率上升。
• delete — 通过指定 contact group 资源名称，删除由已认证用户拥有的某个现有 contact group。针对同一用户的变更请求应按顺序发送，以避免延迟增加和失败率上升。
• get — 通过指定 contact group 资源名称，获取由已认证用户拥有的某个特定 contact group。
• list — 列出由已认证用户拥有的所有 contact group。结果中不包含各 contact group 的成员信息。
• update — 更新由已认证用户拥有的某个现有 contact group 的名称。更新后的 contact group 名称必须在该用户的 contact group 中唯一；若尝试设置为已存在的名称，将返回 HTTP 409 错误。针对同一用户的变更请求应按顺序发送，以避免延迟增加和失败率上升。
• members — 对 members 资源执行的操作

otherContacts

• copyOtherContactToMyContactsGroup — 将一个 “Other contact” 复制为用户 “myContacts” 组中的新联系人。针对同一用户的变更请求应按顺序发送，以避免延迟增加和失败率上升。
• list — 列出所有 “Other contacts”，即未归属于任何 contact group 的联系人。“Other contacts” 通常由用户交互行为自动创建。全量同步（full sync）生成的 sync token 有效期为 7 天。若请求中携带已过期的 sync token，将返回带有 google.rpc.ErrorInfo 的错误，其 reason 字段值为 "EXPIRED_SYNC_TOKEN"。遇到此类错误时，客户端应发起一次不带 sync_token 参数的全量同步请求。
• search — 返回已认证用户的 “Other contacts” 中匹配搜索查询的联系人列表。查询将匹配来源于 OTHER_CONTACT 数据源的联系人的 names、emailAddresses 和 phoneNumbers 字段。重要提示： 搜索前，客户端应先发送一条空查询（empty query）的预热请求（warmup request），以刷新缓存。详见 https://developers.google.com/people/v1/other-contacts#search_the_users_other_contacts

people

• batchCreateContacts — 批量创建新联系人，并返回对应的新建联系人的 PersonResponses。针对同一用户的变更请求应按顺序发送，以避免延迟增加和失败率上升。
• batchUpdateContacts — 批量更新联系人，并返回一个以资源名称为键、以更新后联系人的 PersonResponses 为值的映射表。针对同一用户的变更请求应按顺序发送，以避免延迟增加和失败率上升。
• createContact — 创建一个新联系人，并返回该联系人的 person 资源。若在仅允许单值（singleton）的字段上指定了多个值（适用于 contact 数据源的字段包括：biographies、birthdays、genders、names），则请求将返回 400 错误。针对同一用户的变更请求应按顺序发送，以避免延迟增加和失败率上升。
• deleteContactPhoto — 删除某联系人的头像照片。针对同一用户的变更请求应按顺序执行，以避免锁竞争（lock contention）。
• get — 通过指定资源名称，获取某个人的信息。使用 people/me 表示已认证用户。若未指定 personFields，请求将返回 400 错误。
• getBatchGet — 通过指定一组请求的资源名称，获取若干特定人员的信息。使用 people/me 表示已认证用户。若未指定 personFields，请求将返回 400 错误。
• listDirectoryPeople — 返回已认证用户所在域目录（domain directory）中的域档案（domain profiles）和域联系人（domain contacts）列表。当指定了 sync_token 时，自上次同步以来已被删除的资源将以 PersonMetadata.deleted 设为 true 的 person 形式返回。当指定了 page_token 或 sync_token 时，所有其他请求参数必须与首次调用保持一致。同步请求的写入操作可能存在数分钟的传播延迟（propagation delay）。增量同步（incremental sync）不适用于“写后立即读”（read-after-write）类场景。
• searchContacts — 返回已认证用户分组联系人（grouped contacts）中匹配搜索查询的联系人列表。查询将匹配来源于 CONTACT 数据源的联系人的 names、nickNames、emailAddresses、phoneNumbers 和 organizations 字段。重要提示： 搜索前，客户端应先发送一条空查询（empty query）的预热请求（warmup request），以刷新缓存。详见 https://developers.google.com/people/v1/contacts#search_the_users_contacts
• searchDirectoryPeople — 返回已认证用户所在域目录中匹配搜索查询的域档案和域联系人列表。
• updateContact — 更新现有联系人（person）的联系人数据。非联系人数据字段不会被修改；待更新 person 中的非联系人数据将被忽略。所有在 update_mask 中指定的字段将被完全替换。若待更新联系人未提供 person.metadata.sources，或其中不含 contact 数据源，服务器将返回 400 错误。
• updateContactPhoto — 更新某联系人的头像照片。针对同一用户的变更请求应按顺序发送，以避免延迟增加和失败率上升。
• connections — 对 connections 资源执行的操作

发现可用命令

调用任意 API 方法前，请先检查其详情：

# 浏览资源与方法列表
gws people --help

# 查看某方法所需的参数、类型及默认值
gws schema people..

请根据 gws schema 的输出结果，构造你的 --params 和 --json 参数。