Google RCS Business Messaging API认证求助：OAuth2l及权限错误

问题描述 #

尝试向Google Android Messages客户端发送RCS营销消息，参考官方文档的curl命令发送“Hello World”文本至目标号码。持有服务账号密钥JSON文件，调用API时出现OAuth2l command not found错误。想确认是否需要生成AccessToken并以Bearer方式发起curl请求；另外，通过JWT生成AccessToken作为Bearer调用API时收到403权限不足错误，需明确使用服务账号密钥文件发送RCS消息的方式是否正确，以及如何完成Google RBM API的认证。

错误信息（中文翻译） #

{
    "error": {
        "code": 403,
        "message": "请求的认证范围不足。",
        "status": "PERMISSION_DENIED",
        "details": [
            {
                "@type": "type.googleapis.com/google.rpc.ErrorInfo",
                "reason": "ACCESS_TOKEN_SCOPE_INSUFFICIENT",
                "domain": "googleapis.com",
                "metadata": {
                    "method": "google.communications.rcsbusinessmessaging.v1.RcsBusinessMessagingService.GetCapabilities",
                    "service": "rcsbusinessmessaging.googleapis.com"
                }
            }
        ]
    }
}

解决方案 #

1. 关于OAuth2l command not found错误 #

oauth2l是Google官方用于OAuth2令牌管理的工具，若不想安装该工具，完全可以通过服务账号密钥生成JWT并转换为Bearer Access Token的方式替代，这个方法合规且有效。

2. 403权限不足问题的核心原因及解决 #

你遇到的403错误是因为生成AccessToken时指定的权限范围（Scope）不正确。针对RBM API，必须使用专属scope：

正确scope：https://www.googleapis.com/auth/rcsbusinessmessaging

快速生成AccessToken的方法（推荐用gcloud工具）

# 激活服务账号
gcloud auth activate-service-account --key-file=你的服务账号密钥文件.json
# 生成带正确scope的AccessToken
gcloud auth print-access-token --scope=https://www.googleapis.com/auth/rcsbusinessmessaging

执行后输出的字符串就是可直接使用的Bearer Token。

手动JWT签名方式（需确保scope正确）

• 构造JWT payload时，scope字段必须设置为https://www.googleapis.com/auth/rcsbusinessmessaging
• 将签名后的JWT发送到https://oauth2.googleapis.com/token端点换取AccessToken

使用Bearer Token调用API示例

将curl请求的Authorization头替换为生成的Bearer Token：

curl -X POST "https://rcsbusinessmessaging.googleapis.com/v1/phones/你的目标号码/messages:send" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 生成的AccessToken" \
  -d '{
    "messageText": "Hello World"
  }'

3. 额外检查：服务账号权限配置 #

确保你的服务账号已在Google Cloud控制台的IAM页面被授予RCS Business Messaging Sender角色，否则即使token正确，也会因权限不足被拒绝。

内容的提问来源于stack exchange，提问作者Deepak K T