本教程详细介绍了如何利用Google Apps Script和html Service，在Google Sheets中实现将单元格内容一键复制到本地（android/windows）剪贴板的功能。针对Apps Script无法直接访问客户端剪贴板的限制，本文提供了一种通过创建模态对话框并在其中执行客户端JavaScript复制命令的有效解决方案，确保在不同设备上的兼容性和便捷性。
引言：Apps Script与客户端剪贴板的挑战
Google Apps Script作为一款强大的云端脚本语言，能够与Google Workspace应用（如Google Sheets、Docs、Gmail等）深度集成，实现自动化和定制化功能。然而，Apps Script的运行环境是Google的服务器端，这意味着它无法直接访问用户本地计算机或移动设备的硬件资源，包括操作系统的剪贴板。
许多开发者在尝试实现“一键复制单元格内容到本地剪贴板”功能时，会遇到以下常见误区和失败尝试：
- 直接调用不存在的Apps Script服务：例如尝试使用ClipboardService.getClipboard()或Utilities.copyToClipboard()/Utilities.setClipboard()。这些API在Apps Script标准库中并不存在，或者其设计目的并非用于直接操作客户端剪贴板。
- 在Apps Script中执行浏览器端命令：例如尝试在.gs文件中直接使用document.execCommand(‘copy’)。document对象是浏览器dom（文档对象模型）的一部分，仅在浏览器环境中可用。Apps Script在服务器端执行，无法识别此类命令，因此会导致运行时错误。
- 创建临时DOM元素并尝试复制：即使在Apps Script中模拟创建textarea元素并赋值，然后尝试执行document.execCommand(‘copy’)，也会因为上述原因而失败，因为这些操作都需要在客户端浏览器环境中完成。
为了克服这一限制，我们需要引入一个能够在客户端浏览器中执行代码的机制，这就是Google Apps Script的HTML Service。
解决方案核心思想：HTML Service作为桥梁
HTML Service允许Apps Script生成和提供HTML页面，这些页面在用户的浏览器中运行。这意味着我们可以在这些HTML页面中嵌入标准的客户端JavaScript，从而利用浏览器提供的DOM API（如document.execCommand(‘copy’)）来操作用户的剪贴板。
解决方案的核心思路是：
- Apps Script (服务器端)：负责获取Google Sheets中活动单元格的内容。
- HTML Service (客户端)：Apps Script将获取到的内容传递给一个模态对话框（或侧边栏）中显示的HTML页面。
- 客户端JavaScript (浏览器端)：在HTML页面中，通过JavaScript将接收到的内容放置到一个临时、通常是隐藏的文本输入框中，然后选中该文本框的内容，并执行document.execCommand(‘copy’)命令将其复制到剪贴板。
- 用户交互：为了符合浏览器安全策略（防止恶意网站未经用户许可复制内容），document.execCommand(‘copy’)通常需要由用户触发（例如点击按钮）。
- 回调与关闭：复制完成后，客户端JavaScript可以通过google.script.run回调Apps Script，通知其关闭模态对话框。
实现步骤
我们将通过两个文件来完成此功能：一个Apps Script文件（Code.gs）和一个HTML模板文件（CopyDialog.html）。
1. Apps Script文件 (Code.gs)
此文件包含用于获取单元格内容、打开模态对话框以及处理客户端回调的Apps Script函数。
/** * 获取当前活动单元格的内容，并将其传递给HTML模态对话框进行复制。 * 此函数将被Google Sheets中的按钮触发。 */ function copyActiveCellToClipboard() { // 获取当前活动电子表格和活动单元格 var ss = SpreadsheetApp.getActiveSpreadsheet(); var cell = ss.getActiveCell(); var cellValue = cell.getValue(); // 获取单元格的值 // 创建HTML模板文件 var htmlTemplate = HtmlService.createTemplateFromFile('CopyDialog'); // 将单元格值作为变量传递给HTML模板 htmlTemplate.valueToCopy = cellValue; // 评估HTML模板并创建HTML输出对象 var htmlOutput = htmlTemplate.evaluate() .setWidth(350) // 设置对话框宽度 .setHeight(150); // 设置对话框高度 // 在Google Sheets界面中显示模态对话框 SpreadsheetApp.getUi().showModalDialog(htmlOutput, '复制内容到剪贴板'); } /** * 这是一个由客户端JavaScript调用的Apps Script占位函数。 * 它的主要作用是触发客户端的withSuccessHandler回调，以便关闭对话框。 * 可以在此函数中添加日志记录或其他服务器端操作。 */ function justADelay() { // 可以在此添加一些服务器端逻辑，例如日志记录 // Logger.log('客户端已请求关闭对话框。'); } /** * (可选) 在Google Sheets中创建一个可点击的按钮，用于触发复制功能。 * 运行此函数一次即可在工作表中添加按钮
