能否通过Google Apps Script实现特定谷歌文档打开时嵌入全屏可交互iframe？

核心结论 #

直接通过Google Apps Script在谷歌文档编辑器内嵌入具备完整交互（指针锁定、音频播放、全键盘交互）的全屏iframe不可行，受限于谷歌文档的沙箱权限和自动触发机制，但可以通过以下替代方案实现近似需求。

为什么直接用GAS无法实现 #

• 编辑器沙箱限制：谷歌文档的编辑区域对自定义HTML/iframe有严格的同源策略和权限管控，指针锁定、全屏API这类高权限功能无法在文档内嵌的iframe中启用；GAS提供的侧边栏、对话框也无法完全覆盖编辑器区域，且交互权限被大幅限制。
• 自动触发限制：Google Apps Script的onOpen函数仅能添加菜单、打开侧边栏，无法在文档打开时直接向编辑区插入全屏内容，更无法自动触发需要用户授权的高权限交互。

可行替代方案 #

方案1：侧边栏嵌入近似全屏iframe（保留文档编辑器入口）

虽然无法完全覆盖文档编辑区，但可以创建占满侧边栏的iframe，尽可能接近全屏效果，同时保留部分交互能力：

1. 打开目标谷歌文档，点击「扩展程序>Apps Script」创建绑定脚本
2. 编写绑定触发逻辑：

function onOpen() {
  DocumentApp.getUi()
    .createMenu('嵌入网站')
    .addItem('打开全屏视图', 'showFullscreenIframe')
    .addToUi();
}

function showFullscreenIframe() {
  const html = HtmlService.createHtmlOutputFromFile('IframeView')
    .setTitle('外部网站')
    .setWidth(900)
    .setHeight(700); // 设为接近屏幕尺寸的数值
  DocumentApp.getUi().showSidebar(html);
}

3. 创建IframeView.html文件，写入iframe代码（注意外部网站需允许被嵌入，即服务器未设置X-Frame-Options: DENY）：

<!DOCTYPE html>
<html>
  <body style="margin: 0; padding: 0;">
    <iframe 
      src="你的外部网站URL" 
      style="width: 100%; height: 100vh; border: none;"
      allow="fullscreen; microphone; autoplay">
    </iframe>
  </body>
</html>

注意：指针锁定、全键盘交互仍可能受浏览器沙箱限制，需外部网站主动通过用户交互触发相关权限请求。

方案2：自定义网页整合文档与外部网站（完整交互支持）

如果无需在谷歌文档编辑器内操作，可通过自定义网页实现完整功能：

1. 将目标谷歌文档发布为网页（点击「文件>发布到网络」，选择「网页」类型获取发布链接）
2. 编写自定义网页代码，实现打开时自动加载全屏外部网站，同时保留文档入口：

<!DOCTYPE html>
<html>
<head>
  <style>
    * {margin: 0; padding: 0;}
    .fullscreen-iframe {
      position: fixed;
      top: 0; left: 0;
      width: 100vw; height: 100vh;
      border: none;
      z-index: 999;
    }
    .doc-access {
      position: fixed;
      top: 20px; right: 20px;
      z-index: 1000;
      padding: 10px 15px;
      background: #fff;
      border-radius: 4px;
      text-decoration: none;
      color: #1a73e8;
    }
  </style>
</head>
<body>
  <iframe 
    class="fullscreen-iframe"
    src="你的外部网站URL"
    allow="fullscreen; microphone; autoplay; pointer-lock">
  </iframe>
  <a class="doc-access" href="谷歌文档发布后的网页URL" target="_blank">查看原文档</a>
</body>
</html>

此方案可支持完整的指针锁定、音频播放和键盘交互，因为自定义网页的iframe权限限制远低于谷歌文档编辑器。

关键权限说明 #

• 指针锁定：必须由用户主动交互（如点击按钮）触发请求，浏览器不允许自动锁定指针。
• 音频播放：需外部网站配置autoplay权限，且浏览器需存在用户交互记录（否则会阻止自动播放）。
• 嵌入权限：外部网站的服务器响应头不能设置X-Frame-Options: DENY或SAMEORIGIN，否则无法嵌入。

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