关于通过Google People API获取谷歌账号附加邮箱地址的技术咨询

可行解决方案 #

要获取谷歌账号的所有关联邮箱（包括主地址、别名/次要地址），按以下步骤操作：

• 权限范围：使用 https://www.googleapis.com/auth/userinfo.email 这个范围，它能访问账号级别的邮箱信息，包含别名地址。
• API调用参数：调用People API的 people.get 接口时，必须指定：
  • resourceName=people/me
  • personFields=emailAddresses
  • sources=READ_SOURCE_TYPE_ACCOUNT

为什么之前的尝试失败 #

1. https://www.googleapis.com/auth/user.emails.read 仅能获取用户公开个人资料中的邮箱，不包含账号设置里的备用邮箱。
2. https://www.googleapis.com/auth/profile.emails.read 已被谷歌弃用，不再提供支持。
3. 你之前添加的 READ_SOURCE_TYPE_PROFILE 和 READ_SOURCE_TYPE_CONTACT 仅涉及个人资料和联系人数据，不覆盖账号本身的备用邮箱信息，所以没有返回额外内容。

请求示例（curl） #

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://people.googleapis.com/v1/people/me?personFields=emailAddresses&sources=READ_SOURCE_TYPE_ACCOUNT"

返回结果的 emailAddresses 数组会包含所有关联邮箱，每个对象的 type 字段会标注地址类型：account 为主地址，alternate 为别名/次要地址。

注意事项 #

• 确保云项目已正确启用People API。
• 该方案适用于普通谷歌个人账号；针对G Suite/Workspace账号，如需获取成员的别名邮箱，需结合Admin SDK接口并拥有管理员权限。
• 测试前确认目标账号已添加并验证了备用邮箱地址。

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