使用Python开发Google Sheets扩展插件的部署配置问题求助

架构老林

2026-8-27

「选择托管基础设施并搭建HTTPS端点」操作拆解

用Python写的Google Sheets插件属于非Apps Script运行时插件，Google服务器不能直接运行你本地写的Python代码，必须把代码部署到有公网可信HTTPS地址的服务上，Google才能把用户在表格里触发的插件请求转发到你的代码执行，这一步具体操作如下：

新手优先选免运维的托管平台，不用自己配服务器、搞SSL证书：可选Google Cloud Run、Google Cloud Functions这类Google自家Serverless服务，也可以选其他支持Python部署的Serverless平台，这类平台部署完成后会自动给你分配符合要求的HTTPS公网地址，省掉证书、域名配置的麻烦
你的Python后端需要实现至少2个POST类型的接口，返回符合Google插件规范的JSON结构：
- 首页加载接口：用户点击打开插件时，Google会调用这个接口，返回插件要展示的卡片UI配置
- 操作回调接口：用户点击插件按钮、提交表单时，Google会把操作参数传到这个接口，你在这里写调用Sheets API编辑指定表格的核心逻辑
本地调试阶段不用每次改代码都部署线上，可以用内网穿透工具把本地运行的Python服务映射成临时公网HTTPS地址做测试，调试结束及时关闭穿透避免安全风险
注意：所有接口地址必须是https://开头，HTTP地址、自签名SSL证书的HTTPS地址都会被Google直接拦截，无法通过校验

「创建部署资源」第9步卡壳排查方案

官方教程这一步是要求填写你部署好的后端HTTPS接口地址、关联插件权限配置，卡在这里基本都是以下问题，逐个排查即可：

先验证你填写的接口地址公网可达：用curl或者接口测试工具往这个地址发POST请求，确认能正常返回响应，地址公网不通的话Google校验会直接失败，不会给出明确报错
检查填写的接口路径是否准确：要填完整的接口路径，不要只填根域名，注意末尾不要多打斜杠、不要漏路径片段
确认操作账号权限足够：如果用Google Cloud部署，要给当前操作账号绑定对应服务的开发者权限、Workspace插件管理权限，权限不足时页面经常无响应，不会弹出权限不足提示
检查OAuth同意屏配置：如果OAuth同意屏还处于测试状态，必须把用来测试插件的Google账号全部加到测试用户列表里，否则权限范围校验不通过，没法提交部署配置
如果提交按钮完全点不动，直接开Chrome无痕模式重新登录控制台操作，大多是浏览器缓存的前端脚本异常导致的
本地调试阶段不要填localhost开头的本地地址，这类地址公网不可达，肯定过不了校验，先用内网穿透生成HTTPS地址再填写

最小Python后端参考（Flask框架）

from flask import Flask, request, jsonify
app = Flask(__name__)

# 插件首页加载接口
@app.route("/addon/home", methods=["POST"])
def load_home():
    return jsonify({
        "cards": [{
            "sections": [{
                "widgets": [{"textParagraph": {"text": "Sheets编辑插件"}}]
            }]
        }]
    })

# 表格编辑逻辑接口
@app.route("/addon/edit", methods=["POST"])
def do_edit():
    # 此处编写调用Sheets API编辑目标表格的逻辑
    return jsonify({
        "renderActions": {"action": {"navigate": "back"}}
    })

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=8080)

内容的提问来源于stack exchange，提问作者Amar.Kanakamedala