使用Google People API创建联系人时添加账号已有标签的方法咨询

• 核心注意点：People API的标签关联是基于标签唯一ID完成的，不支持通过标签名称直接匹配绑定，这是绝大多数绑定失败的根本原因。
• 前置准备阶段必须先获取账号下所有已存在标签的唯一ID，调用contactGroups.list接口拉取列表时，带上contactGroupSources=["CONTACT_SOURCE_USER"]过滤参数，就能筛出你个人账号下手动创建的自定义标签，每个返回条目里的contactGroupId字段就是后续绑定要用到的唯一标识。

• 不需要分两次请求（先建联系人再打标），直接在createContact接口的请求体里嵌入绑定关系即可，减少接口调用次数的同时避免异步延迟导致的绑定失效。
• 在请求体的groupMemberships字段数组中，逐一把提前获取到的目标标签ID按格式填入，示例请求片段：

{
  "names": [{"givenName": "示例联系人"}],
  "phoneNumbers": [{"value": "13xxxxxxxxx"}],
  "groupMemberships": [
    {"contactGroupId": "提前从contactGroups.list获取的标签ID"}
  ]
}

• 不要在groupMemberships中直接传入标签的显示名称，接口没有名称解析能力，传值和实际ID不匹配时会直接忽略绑定关系，不会返回明确报错。
• 确认OAuth授权scope覆盖了完整的联系人读写权限，必须包含https://www.googleapis.com/auth/contacts，窄权限下无法拉取标签列表，也无法执行绑定操作。
• 绑定系统内置标签（如星标联系人、常用联系人）时，要使用固定内置ID：比如星标联系人的固定ID为starred，不需要通过列表接口额外查询。
• 如果选择创建完联系人之后再补绑定关系，调用updateContact接口时必须在请求参数中把groupMemberships加入updatePersonFields字段列表，否则传入的绑定关系会被接口直接丢弃。

内容的提问来源于stack exchange，提问作者Henrique Chagas