如何在Google Workspace插件环境下为Google Sheets添加自定义函数？

具体操作步骤 #

Google Workspace插件和普通Editor插件逻辑不同，要给Sheets添加自定义函数，得结合脚本代码和插件配置来实现，具体如下：

• 1. 整理自定义函数代码
  把你提供的GETTAX函数放到插件的Apps Script项目的.gs文件里（比如默认的Code.gs），先去掉代码里多余的逗号，修正后代码如下：

  function GETTAX(price, rate) {
    const tax = price * rate;
    const dollarUS = Intl.NumberFormat("en-US", {
      style: "currency",
      currency: "USD",
    });
    const result = dollarUS.format(tax);
    return result;
  }
  

• 2. 配置插件清单文件
  找到项目里的appsscript.json文件（如果没显示，就在编辑器右上角「设置」里勾选「显示清单文件」），在addOns节点下添加sheets配置，明确声明自定义函数的信息，让Sheets能识别到它。示例配置片段：

  {
    "timeZone": "America/New_York",
    "dependencies": {},
    "exceptionLogging": "STACKDRIVER",
    "runtimeVersion": "V8",
    "addOns": {
      "common": {
        "name": "税务计算插件",
        "logoUrl": "https://example.com/logo.png",
        "layoutProperties": {
          "primaryColor": "#4285F4"
        },
        "homepageTrigger": {
          "runFunction": "showHomepage",
          "enabled": true
        }
      },
      "sheets": {
        "customFunctions": {
          "functions": [
            {
              "functionName": "GETTAX",
              "description": "计算商品税额并返回美元格式结果",
              "parameters": [
                {
                  "name": "price",
                  "description": "商品税前价格"
                },
                {
                  "name": "rate",
                  "description": "税率（比如0.08代表8%）"
                }
              ],
              "returnValue": {
                "description": "格式化后的美元税额"
              }
            }
          ]
        }
      }
    }
  }
  

• 3. 插件启动后直接使用
  当用户安装插件并在Sheets里打开它（比如点击侧边栏的插件入口），Sheets会自动读取清单里声明的自定义函数，这时候用户直接在单元格输入=GETTAX(100, 0.08)就能调用函数了。

注意事项 #

• 自定义函数必须是全局顶层函数，不能嵌套在其他函数或类内部。
• 函数里尽量别用需要授权的服务（比如调用外部API），否则会弹出授权窗口，影响使用体验。
• 测试时，把插件部署为测试版本，安装到自己的Google账号后，打开Sheets启动插件即可测试函数。

内容的提问来源于stack exchange，提问作者Let Me Tink About It