如何用SendGrid Python API为已创建的动态模板添加版本？

前提准备 #

• 已获取具备模板编辑权限的SendGrid API密钥
• 已拥有目标动态模板的template_id（创建模板时返回的ID）
• 已安装SendGrid Python SDK：

pip install sendgrid

完整代码示例 #

import os
from sendgrid import SendGridAPIClient

# 初始化SendGrid客户端
sg = SendGridAPIClient(os.environ.get('SENDGRID_API_KEY'))

# 目标动态模板ID
template_id = "你的动态模板ID"

# 构造模板版本数据
version_data = {
    "name": "V2 - 新版注册通知模板",  # 自定义版本名称，便于识别
    "html_content": "<html><body>Hi {{username}}, 欢迎加入！你的专属邀请码是 {{invite_code}}</body></html>",  # 带Handlebars变量的HTML模板
    "subject": "欢迎加入 | {{platform_name}}",  # 支持动态变量的邮件主题
    "active": 1,  # 1表示设为当前激活版本，0为禁用状态
    "plain_content": "Hi {{username}}, 欢迎加入！你的专属邀请码是 {{invite_code}}"  # 可选纯文本版本
}

try:
    # 调用API创建模板版本
    response = sg.client.templates._(template_id).versions.post(request_body=version_data)
    print(f"版本创建成功，版本ID: {response.body}")
    print(f"响应状态码: {response.status_code}")
except Exception as e:
    print(f"创建失败: {str(e)}")

关键参数说明 #

• name：建议包含版本号和更新描述，方便后续模板版本管理
• html_content：核心动态模板内容，使用Handlebars语法定义变量（如{{username}}）
• active：设置为1会将该版本设为模板的默认生效版本；如需保留旧版本为默认，设为0即可
• plain_content：为不支持HTML的邮件客户端提供纯文本备选内容，可选配置

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