Google Wallet API OAuth 2.0请求wallet_object.issuer scope遇invalid_scope错误

问题概述 #

请求https://www.googleapis.com/auth/wallet_object.issuer权限范围时触发invalid_scope错误，具体表现：

• 在OAuth同意屏幕手动添加该范围时提示无效
• 生成授权URL访问时返回错误
• 使用OAuth 2.0 Playground测试仍报错

核心原因 #

wallet_object.issuer属于Google Wallet API的敏感权限，仅在满足以下条件时可用：

1. 已在Google Wallet控制台完成Issuer注册并关联对应Cloud项目
2. Cloud项目已正确启用Wallet API且权限同步完成
3. OAuth配置符合官方要求

解决步骤 #

1. 完成Google Wallet Issuer注册 #

该权限范围仅对已注册的Wallet Issuer开放，需先完成Issuer创建：

• 打开Google Wallet控制台，登录后选择你的Cloud项目
• 创建新的Issuer，按提示完成必要的验证流程（如适用）
• 确保Issuer与当前Cloud项目绑定成功

2. 正确添加OAuth范围 #

避免手动输入范围，通过官方列表选择减少错误：

• 进入Cloud Console的APIs & Services > OAuth同意屏幕
• 点击「添加范围」，在弹出列表中找到Google Wallet API对应的https://www.googleapis.com/auth/wallet_object.issuer范围并添加
• 若列表中无此范围，说明Issuer未关联或API权限未同步，等待1-2小时后重试

3. 验证OAuth客户端凭据配置 #

• 确认创建的OAuth 2.0客户端凭据属于已关联Issuer的Cloud项目
• 检查重定向URI是否与代码中配置的http://localhost:5173/oauth2callback完全一致

4. 修复代码遗漏（可选） #

你的代码片段缺少重定向逻辑，补充后确保授权流程完整：

app.get('/generate-auth-url', (req, res) => {
  const authUrl = oAuth2Client.generateAuthUrl({
    access_type: 'offline',
    scope: ['https://www.googleapis.com/auth/wallet_object.issuer']
  });
  res.redirect(authUrl); // 补充重定向到授权URL
});

5. 排查额外可能问题 #

• 若OAuth同意屏幕处于测试状态，确保测试用户列表中添加了你的登录账号
• 确认你的Google账号拥有该Cloud项目的Owner或Editor权限（敏感范围需要高权限账号操作）
• 检查Cloud Console的APIs & Services > Dashboard，确认Google Wallet API确实处于启用状态

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