首页 > web前端 > js教程 > 正文

使用Google Apps Script将Google文档导出为PDF并实现下载

碧海醫心
发布: 2025-11-02 11:53:01
原创
385人浏览过

使用google apps script将google文档导出为pdf并实现下载

本文详细介绍了如何利用Google Apps Script将Google文档程序化地转换为PDF格式,并提供下载链接。通过结合`DriveApp`服务和客户端脚本,用户可以从Google表格触发操作,自动生成文档内容,将其导出为PDF文件,并直接下载,实现高效的自动化工作流程。

在日常工作中,我们经常需要将Google文档中的内容导出为PDF格式,以便于分享、存档或打印。当这个过程需要自动化,例如根据Google表格中的用户输入动态生成文档并导出时,Google Apps Script便成为一个强大的工具。本文将详细指导您如何使用Google Apps Script实现这一功能,包括文档的生成、转换为PDF以及触发下载的完整流程。

核心概念:DriveApp与Blob服务

Google Apps Script提供了DriveApp服务,允许脚本与Google Drive中的文件和文件夹进行交互。这是将Google文档转换为PDF的关键。DriveApp可以根据文件ID获取文件对象,而文件对象又提供了getAs()方法,能够将文件内容转换为指定MIME类型的Blob(二进制大对象)。

当我们需要将Google文档转换为PDF时,getAs()方法将与MIME类型'application/pdf'结合使用。

逐步实现:Google文档转PDF并下载

我们将分步构建一个功能,该功能从Google表格获取参数,生成Google文档,然后将其转换为PDF并提供下载。

步骤1:创建或获取Google文档ID

首先,我们需要一个Google文档来操作。在许多自动化场景中,这个文档是动态创建的。创建文档后,获取其ID是后续操作的基础。

/**
 * 根据用户输入生成Google文档内容。
 * 注意:为确保转换成功,文档内容写入后需要保存并关闭。
 */
function createGoogleDocFromSheetData() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var data = sheet.getDataRange().getValues();

  // 假设用户参数在第二列的前6行
  var userParams = [];
  for(var i = 0; i <= 5; i++) {
    userParams.push(data[i][1]);
  }

  // 模拟数据生成函数,实际应用中可能更复杂
  var problems = genData(
    userParams[0], userParams[1], userParams[2],
    userParams[3], userParams[4], userParams[5]
  );

  // 创建Google文档
  var documentTitle = `Generated Problems: ${userParams.toString().replace(/,/g, ", ")}`;
  var document = DocumentApp.create(documentTitle);
  var documentId = document.getId(); // 获取新创建文档的ID
  var body = document.getBody();

  // 设置文档样式
  var FontStyle = {};
  FontStyle[DocumentApp.Attribute.FONT_FAMILY] = "Courier";
  FontStyle[DocumentApp.Attribute.FONT_SIZE] = 24;
  body.setAttributes(FontStyle);

  // 写入内容
  for(var i = 0; i < problems.length; i++) {
    body.appendParagraph(problems[i].replace(/,/g, ", ") + "\n");
  }

  // !!! 关键步骤:保存并关闭文档,确保所有更改都被写入Drive
  document.saveAndClose(); 

  return documentId; // 返回文档ID供后续使用
}

// 模拟数据生成函数(实际应用中需要具体实现)
function genData(param1, param2, param3, param4, param5, param6) {
  // 此处应包含您的业务逻辑来生成内容
  return [
    `参数1: ${param1}, 参数2: ${param2}`,
    `参数3: ${param3}, 参数4: ${param4}`,
    `参数5: ${param5}, 参数6: ${param6}`,
    "这是根据您的输入生成的一些示例文本。",
    "请根据实际需求替换此处的逻辑。"
  ];
}
登录后复制

重要提示: 在将文档转换为PDF之前,务必调用document.saveAndClose()。这确保了所有写入文档的内容都已同步到Google Drive,否则转换出的PDF可能不包含最新内容。

步骤2:将文档转换为PDF Blob

有了文档ID后,我们可以使用DriveApp服务获取该文档,并将其内容转换为PDF格式的Blob。

/**
 * 将指定ID的Google文档转换为PDF Blob。
 * @param {string} documentId Google文档的ID。
 * @returns {GoogleAppsScript.Base.Blob} PDF格式的Blob对象。
 */
function convertDocToPdfBlob(documentId) {
  var googleDocFile = DriveApp.getFileById(documentId);
  var pdfBlob = googleDocFile.getAs('application/pdf');
  return pdfBlob;
}
登录后复制

步骤3:在Google Drive中创建PDF文件

转换得到的PDF Blob可以用来在Google Drive中创建一个新的PDF文件。您可以为这个文件指定一个有意义的名称。

Google AI Studio
Google AI Studio

Google 推出的基于浏览器的集成开发环境

Google AI Studio107
查看详情 Google AI Studio
/**
 * 在Google Drive中创建PDF文件。
 * @param {GoogleAppsScript.Base.Blob} pdfBlob PDF格式的Blob对象。
 * @param {string} fileName PDF文件的名称。
 * @returns {GoogleAppsScript.Drive.File} 新创建的PDF文件对象。
 */
function createPdfFileInDrive(pdfBlob, fileName) {
  var pdfFile = DriveApp.createFile(pdfBlob).setName(fileName);
  return pdfFile;
}
登录后复制

步骤4:获取PDF下载链接

创建了PDF文件后,我们可以获取其下载链接。这个链接可以直接用于触发用户的下载操作。

/**
 * 获取PDF文件的下载URL。
 * @param {GoogleAppsScript.Drive.File} pdfFile PDF文件对象。
 * @returns {string} PDF文件的下载URL。
 */
function getPdfDownloadUrl(pdfFile) {
  // getDownloadUrl()通常需要用户登录,且在某些浏览器中可能需要额外的权限确认
  // 对于直接下载,此链接通常会触发浏览器下载行为
  return pdfFile.getDownloadUrl();
}
登录后复制

步骤5:触发用户下载(客户端交互)

Google Apps Script的服务器端代码无法直接在用户的浏览器中打开新标签页或触发下载。要实现这一点,我们需要结合客户端JavaScript。当脚本从Google表格中的按钮触发时,通常通过google.script.run接口实现服务器端与客户端的通信。

Code.gs (服务器端脚本 - 完整示例)

/**
 * 完整流程:从Google表格数据生成Google文档,转换为PDF,并返回下载URL。
 * 此函数将被客户端脚本调用。
 * @returns {string} PDF文件的下载URL。
 */
function generateAndGetPdfDownloadLink() {
  // 1. 根据表格数据创建Google文档并获取ID
  var documentId = createGoogleDocFromSheetData(); // 调用前面定义的函数

  // 获取文档标题,用于PDF文件名
  var documentTitle = DocumentApp.openById(documentId).getName();

  // 2. 将Google文档转换为PDF Blob
  var pdfBlob = convertDocToPdfBlob(documentId);

  // 3. 在Google Drive中创建PDF文件
  var pdfFileName = documentTitle + ".pdf";
  var pdfFile = createPdfFileInDrive(pdfBlob, pdfFileName);

  // 4. 获取PDF下载链接
  var downloadUrl = getPdfDownloadUrl(pdfFile);

  // 可选:如果生成的Google文档只是临时文件,可以考虑将其删除或移动到特定文件夹
  // DriveApp.getFileById(documentId).setTrashed(true); 

  return downloadUrl; // 将下载URL返回给客户端
}

// 辅助函数定义(与上述步骤中的函数相同)
function createGoogleDocFromSheetData() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var data = sheet.getDataRange().getValues();

  var userParams = [];
  for(var i = 0; i <= 5; i++) {
    userParams.push(data[i][1]);
  }

  var problems = genData(
    userParams[0], userParams[1], userParams[2],
    userParams[3], userParams[4], userParams[5]
  );

  var documentTitle = `Generated Problems: ${userParams.toString().replace(/,/g, ", ")}`;
  var document = DocumentApp.create(documentTitle);
  var documentId = document.getId();
  var body = document.getBody();

  var FontStyle = {};
  FontStyle[DocumentApp.Attribute.FONT_FAMILY] = "Courier";
  FontStyle[DocumentApp.Attribute.FONT_SIZE] = 24;
  body.setAttributes(FontStyle);

  for(var i = 0; i < problems.length; i++) {
    body.appendParagraph(problems[i].replace(/,/g, ", ") + "\n");
  }
  document.saveAndClose(); 
  return documentId;
}

function genData(param1, param2, param3, param4, param5, param6) {
  return [
    `参数1: ${param1}, 参数2: ${param2}`,
    `参数3: ${param3}, 参数4: ${param4}`,
    `参数5: ${param5}, 参数6: ${param6}`,
    "这是根据您的输入生成的一些示例文本。",
    "请根据实际需求替换此处的逻辑。"
  ];
}

function convertDocToPdfBlob(documentId) {
  var googleDocFile = DriveApp.getFileById(documentId);
  var pdfBlob = googleDocFile.getAs('application/pdf');
  return pdfBlob;
}

function createPdfFileInDrive(pdfBlob, fileName) {
  var pdfFile = DriveApp.createFile(pdfBlob).setName(fileName);
  return pdfFile;
}

function getPdfDownloadUrl(pdfFile) {
  return pdfFile.getDownloadUrl();
}
登录后复制

Sheet.html (或直接在Google表格中插入绘图/按钮并分配脚本)

为了从Google表格触发下载,您可以在表格中插入一个绘图或按钮,并为其分配一个客户端脚本函数。

  1. 在Google表格中创建按钮:

    • 插入 > 绘图。
    • 绘制一个形状,添加文本如“下载PDF”。
    • 保存并关闭。
    • 右键点击绘图,选择“分配脚本”。
    • 输入您希望执行的客户端函数名,例如 handleDownloadClick。
  2. 在您的Apps Script项目(Code.gs文件)中添加以下HTML文件:

    • 文件 > 新建 > Html文件,命名为 Dialog.html。
    • 将以下内容粘贴到 Dialog.html 中:
    <!DOCTYPE html>
    <html>
      <head>
        <base target="_top">
        <script>
          // 客户端脚本函数,当按钮被点击时调用
          function handleDownloadClick() {
            // 显示加载指示器
            document.getElementById('status').innerText = '正在生成PDF,请稍候...';
            document.getElementById('downloadButton').disabled = true;
    
            // 调用服务器端函数 generateAndGetPdfDownloadLink
            google.script.run
                  .withSuccessHandler(onDownloadSuccess)
                  .withFailureHandler(onDownloadFailure)
                  .generateAndGetPdfDownloadLink();
          }
    
          // 服务器端函数成功执行后的回调
          function onDownloadSuccess(downloadUrl) {
            document.getElementById('status').innerText = 'PDF已生成!';
            // 在新标签页中打开下载链接,触发下载
            window.open(downloadUrl, '_blank');
            document.getElementById('downloadButton').disabled = false;
          }
    
          // 服务器端函数执行失败后的回调
          function onDownloadFailure(error) {
            document.getElementById('status').innerText = '生成PDF失败: ' + error.message;
            document.getElementById('downloadButton').disabled = false;
            console.error(error);
          }
    
          // 页面加载完成后,将handleDownloadClick函数暴露给全局作用域,以便按钮可以调用
          window.onload = function() {
            document.getElementById('downloadButton').onclick = handleDownloadClick;
          };
        </script>
      </head>
      <body>
        <button id="downloadButton">下载PDF</button>
        <p id="status"></p>
      </body>
    </html>
    登录后复制
  3. 在Code.gs中添加一个函数来打开这个对话框:

    /**
     * 在Google表格中显示一个包含下载按钮的自定义对话框。
     */
    function showDownloadDialog() {
      var html = HtmlService.createHtmlOutputFromFile
    登录后复制

以上就是使用Google Apps Script将Google文档导出为PDF并实现下载的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习
PHP中文网抖音号
发现有趣的

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号