如何从Google Sheet取数到Gmail插件？遇openById权限错误

这个权限问题其实是Gmail插件的运行机制导致的——Gmail插件默认的授权范围只覆盖Gmail相关操作，没有包含Google Sheets的访问权限，而且直接在卡片构建函数里调用openById会触发受限上下文的权限拦截。下面给你一步步解决的方案：

1. 补充必要的OAuth授权范围 #

首先要修改你的appsscript.json配置文件，添加Google Sheets的访问权限范围。如果只是读取数据，添加只读范围就够了：

{
  "oauthScopes": [
    "https://www.googleapis.com/auth/gmail.addons.current.action.compose",
    "https://www.googleapis.com/auth/spreadsheets.readonly"
  ]
}

如果需要读写Sheet，就把spreadsheets.readonly换成https://www.googleapis.com/auth/spreadsheets。

2. 调整代码逻辑，处理授权流程 #

你不能直接在createWidgetCard这类卡片初始化函数里调用Sheet的访问方法，因为插件加载时的上下文没有足够权限。正确的做法是：

• 先尝试访问Sheet，若触发权限错误则展示授权引导按钮
• 用户完成授权后再重新获取数据并渲染卡片

比如修改你的代码：

function createWidgetCard() {
  try {
    // 替换成你的Sheet ID和目标范围
    const sheet = SpreadsheetApp.openById("你的Sheet ID").getSheetByName("Sheet1");
    const targetData = sheet.getRange("A1").getValue();
    
    // 成功获取数据后，渲染带数据的卡片
    return CardService.newCardBuilder()
      .setHeader(CardService.newCardHeader()
        .setTitle('Widget demonstration')
        .setSubtitle(`获取到的数据：${targetData}`)
        .setImageStyle(CardService.ImageStyle.SQUARE)
        .setImageUrl('https://xxx'))
      .build();
  } catch (e) {
    // 捕获权限错误，展示授权按钮
    if (e.message.includes("permission to call openById")) {
      const authAction = CardService.newAuthorizationAction()
        .setAuthorizationUrl(ScriptApp.getAuthorizationUrl())
        .setResourceDisplayName("你的Google Sheet数据");
      
      return CardService.newCardBuilder()
        .addSection(CardService.newCardSection()
          .addWidget(CardService.newTextParagraph()
            .setText("需要授权访问Google Sheet才能展示数据"))
          .addWidget(CardService.newButton()
            .setText("授权")
            .setAuthorizationAction(authAction)))
        .build();
    }
    // 抛出其他类型的错误以便排查
    throw e;
  }
}

3. 重新部署插件 #

修改完配置和代码后，一定要重新部署你的Gmail插件，选择“新版本”发布，确保用户安装的是更新后的版本，新的授权范围才能生效。

关键注意点 #

• 遵循最小权限原则：能用只读范围就不要用读写权限，避免过度授权
• 不要在卡片初始化的同步逻辑里直接执行跨服务操作，通过授权引导处理权限缺失场景

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