如何从Google People API获取notes字段 官方文档无对应参数说明

字段对应关系 #

2024年最新版谷歌People API中，联系人的「notes」内容对应返回字段为biographies，不存在单独的notes返回字段，你之前的字段选型是正确的，返回为空是权限或参数配置问题。

正确调用步骤 #

• 首先确认OAuth授权范围配置正确，必须包含https://www.googleapis.com/auth/contacts.readonly或https://www.googleapis.com/auth/contacts，仅使用profile、contacts.other.readonly等低权限范围无法读取联系人私有notes内容
• 调用people.get接口时，personFields参数必须明确传入biographies，不要和其他字段参数漏写、错写
• 接口返回结果中，遍历biographies数组，筛选metadata.source.type = "CONTACT"的条目，其对应的value值就是目标联系人的notes内容

示例请求 #

curl "https://people.googleapis.com/v1/people/{联系人资源ID}?personFields=names,emailAddresses,biographies" \
  -H "Authorization: Bearer {你的访问令牌}"

异常排查 #

如果确认配置正确仍未返回对应内容，可按以下顺序排查：

• 确认目标联系人确实填写了notes内容，且未设置隐藏权限
• 确认当前授权账号对目标联系人有完整的读取权限
• 排查访问令牌是否已获取对应的联系人读取权限，无权限时需重新发起授权流程

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