如何解决Google Apps Script嵌入视频到Gmail邮件时iframe空白问题？

阿华AIGC实验室

2026-5-19

解决Gmail嵌入视频空白的问题（Google Apps Script场景）

我之前帮别人调试过类似的问题，其实核心原因是Gmail出于安全和兼容性考虑，会过滤掉大部分普通iframe以及未授权的外部资源——你本地Chrome能正常播放是因为浏览器对网页的限制远没有邮件客户端严格。下面给你几个实测有效的解决方案，按稳妥程度排序：

方案一：用缩略图+跳转链接（全客户端兼容，最推荐）

这个方法几乎所有邮件客户端都支持，不会出现空白的情况：

如果是YouTube视频：先把视频上传到YouTube（可以设为「未列出」避免公开），然后在HTML模板里用视频的缩略图加跳转链接：

<a href="https://www.youtube.com/watch?v=你的视频ID" target="_blank">
  <img src="https://img.youtube.com/vi/你的视频ID/maxresdefault.jpg" alt="视频预览图" width="640">
</a>
<p>点击图片即可播放视频</p>

如果是Google Drive里的私有视频：先把视频共享权限设为「任何有链接的人都能查看」，然后用Drive的缩略图API生成预览图：

<a href="https://drive.google.com/file/d/你的文件ID/preview" target="_blank">
  <img src="https://drive.google.com/thumbnail?id=你的文件ID" alt="视频预览图" width="640">
</a>

方案二：尝试内嵌HTML5 Video标签（限Gmail等支持的客户端）

如果一定要内嵌播放，Gmail网页版和部分移动端APP支持HTML5的<video>标签，但要满足两个条件：

视频必须是HTTPS协议，且公开可访问（比如Google Drive转成直接下载链接）
视频格式为MP4（兼容性最好）

示例代码：

<video controls width="640" height="360" poster="https://drive.google.com/thumbnail?id=你的文件ID">
  <source src="https://drive.google.com/uc?export=download&id=你的文件ID" type="video/mp4">
  你的邮件客户端不支持内嵌视频，请<a href="https://drive.google.com/file/d/你的文件ID/preview" target="_blank">点击这里</a>观看。
</video>

这里的poster是视频加载前显示的缩略图，src用的是Drive的直接下载链接（把普通共享链接的view?usp=sharing换成uc?export=download&id=文件ID）。

方案三：避开iframe的坑（不推荐直接用普通iframe）

你之前用的iframe被Gmail过滤了，因为Gmail只会信任极少数白名单域名的iframe（比如YouTube的官方嵌入代码偶尔能通过，但不稳定）。如果一定要用iframe，试试YouTube的邮件专用嵌入代码，但实测还是不如前两个方案靠谱：

<iframe width="640" height="360" src="https://www.youtube.com/embed/你的视频ID?rel=0" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

最后检查几个关键细节

确保你的HTML模板是通过HtmlService正确渲染的：

const htmlContent = HtmlService.createTemplateFromFile('你的HTML模板文件名').evaluate().getContent();
GmailApp.sendEmail('收件人邮箱', '邮件标题', '纯文本 fallback', { htmlBody: htmlContent });