调用Google People API batchCreateContacts批量创建联系人返回500错误

问题排查结果 #

你的请求体存在以下明确错误，是触发500内部错误的直接原因：

• 性别字段逻辑冲突：genders下同时设置value: "male"和addressMeAs: "her"，二者取值矛盾，无法通过API底层校验。
• 任职信息逻辑冲突：organizations下设置了current: true（表示当前在职），同时填写了endDate（离职日期），逻辑矛盾。
• 枚举值无效：所有字段的type属性你都填了占位符值（比如addresses下的type: "type"、emailAddresses下的type: "emailAddresses-type"等），这类字段必须使用Google People API规定的枚举有效值，不允许自定义无意义字符串。
• 重复字段配置：readMask中重复填写了phoneNumbers，同时miscKeywords下存在两条type: "OUTLOOK_SUBJECT"的重复条目，属于不规范配置。

修复建议 #

1. 统一性别相关字段的取值，删除冲突的addressMeAs配置或者调整为和value匹配的取值
2. 若联系人当前在职，删除organizations下的endDate字段；若已离职，将current改为false
3. 把所有type字段的占位符替换为API规定的有效值
4. 清理readMask中的重复字段，删除miscKeywords中的重复条目
5. 先提交只包含names、phoneNumbers两个核心字段的最简请求验证接口连通性，再逐步新增其他字段定位问题

内容的提问来源于stack exchange，提问作者Code Guy