Google People API user.gender.read无法返回性别等隐私数据求助

核心原因 #

Google账户的隐私设置优先级高于API权限配置——即便你在控制台添加了对应权限、完成OAuth授权，若目标字段（如性别）的账户隐私设置为严格私密，API仍无法返回对应数据。

具体排查与解决步骤 #

• 调整账户隐私可见性：登录Google账户进入「个人信息」页面，找到对应隐私字段（如「性别」），将可见性从「私密」改为「仅您自己」（自身授权的应用可访问该权限下的数据），保存后重新测试API。
• 确认OAuth授权权限生效：进入Google账户「安全」-「第三方应用访问您的账户」，找到你使用的应用，检查已授权权限列表是否包含user.gender.read（或对应隐私字段的读权限）；若未显示，重新走OAuth授权流程并确保勾选对应权限。
• 校验API请求参数：确保请求的personFields参数明确包含目标字段，比如：personFields=genders,birthday,name,emailAddresses——注意字段名是复数形式（如genders而非gender）。
• API Key无关性说明：隐私数据必须通过OAuth 2.0授权访问，API Key仅支持公开数据查询，因此带不带API Key不影响隐私字段的获取，无需尝试。

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