0

0

Google Apps Script教程:一键将Google文档导出为PDF

聖光之護

聖光之護

发布时间:2025-11-02 14:37:00

|

689人浏览过

|

来源于php中文网

原创

google apps script教程:一键将google文档导出为pdf

本教程将指导您如何利用Google Apps Script自动化将Google文档转换为PDF并提供下载。通过结合使用`DocumentApp`创建文档和`DriveApp`的`getFileById()`及`getAs('application/pdf')`方法,您可以轻松地将动态生成或现有Google文档导出为PDF格式,并提供下载链接,从而提高工作效率。

在日常办公自动化中,将Google文档(Google Docs)动态生成的内容导出为PDF格式是一个常见的需求。无论是报告、发票还是其他定制化文档,能够通过脚本一键生成并下载PDF,都能极大提升工作效率。本教程将详细介绍如何使用Google Apps Script实现这一功能。

核心实现原理

Google Apps Script提供了强大的DriveApp服务,允许我们与Google Drive中的文件进行交互。要将Google文档转换为PDF,主要利用以下两个关键步骤:

  1. 获取Google文档文件对象:通过DriveApp.getFileById(documentId)方法,根据Google文档的ID获取对应的文件对象。
  2. 转换为PDF格式的Blob:文件对象提供了getAs(mimeType)方法。通过指定'application/pdf'作为MIME类型,我们可以将文档内容转换为PDF格式的二进制大对象(Blob)。

获得PDF Blob后,您可以选择将其保存到Google Drive中,或者直接生成一个可供用户下载的链接。

详细步骤与代码示例

我们将基于您现有的脚本进行修改,使其在生成Google文档内容后,能够自动将其转换为PDF并提供下载。

1. 创建和填充Google文档

首先,您的脚本需要像原来一样创建Google文档并填充内容。这是生成PDF的基础。

FreeTTS
FreeTTS

FreeTTS是一个免费开源的在线文本到语音生成解决方案,可以将文本转换成MP3,

下载
/**
 * 根据用户输入创建Google文档,并将其导出为PDF。
 */
function downloadGeneratedDocAsPdf() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var data = sheet.getDataRange().getValues();

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

  // 假设 genData 函数已在其他地方实现,用于根据参数生成内容
  var problems = genData(
    userParams[0], userParams[1], userParams[2],
    userParams[3], userParams[4], userParams[5]
  );

  // 1. 创建Google文档并获取其ID
  var documentTitle = `Problems: ${userParams.toString().replace(/,/g, ", ")}`;
  var doc = DocumentApp.create(documentTitle);
  var docId = doc.getId(); // 获取新创建文档的ID
  var body = doc.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");
  }

  // 确保所有更改已保存并关闭文档,以便DriveApp可以访问最新内容
  doc.saveAndClose();

  // ... 接下来的PDF转换逻辑
}

// genData 函数的占位符,实际应根据您的业务逻辑实现
function genData(param1, param2, param3, param4, param5, param6) {
  Logger.log(`Generating data with params: ${param1}, ${param2}, ${param3}, ${param4}, ${param5}, ${param6}`);
  return ["这是生成的第一行内容。", "这是生成的第二行内容,包含更多细节。"];
}

2. 将Google文档转换为PDF Blob

文档创建并保存后,我们可以使用DriveApp将其转换为PDF。

// 承接 downloadGeneratedDocAsPdf 函数内部

  // 2. 将Google文档转换为PDF Blob
  var docFile = DriveApp.getFileById(docId); // 根据文档ID获取文件对象
  var pdfBlob = docFile.getAs('application/pdf'); // 将文件内容转换为PDF格式的Blob

3. 在Google Drive中创建PDF文件(可选)

您可以选择将这个PDF Blob作为一个新的文件保存到Google Drive中。这样做的好处是,您可以得到一个持久的PDF文件,并能更方便地获取其下载链接。

// 承接 downloadGeneratedDocAsPdf 函数内部

  // 3. (可选)在Google Drive中创建PDF文件并命名
  // 如果您只是想直接下载而不保留在Drive中,可以跳过这一步,但通常建议创建
  var pdfFileName = `${documentTitle.replace(/[: ]/g, "_")}.pdf`; // 清理标题作为文件名
  var pdfFile = DriveApp.createFile(pdfBlob).setName(pdfFileName); // 在Drive中创建新文件

4. 获取PDF的查看/下载链接

获取PDF文件后,我们需要一个URL来让用户访问或下载它。

// 承接 downloadGeneratedDocAsPdf 函数内部

  // 4. 获取PDF的查看/下载链接
  // getDownloadUrl() 可以直接获取下载链接,但Apps Script中直接触发下载可能受权限限制。
  // 更推荐的方式是打开PDF的预览链接,用户可以在预览界面选择下载。
  var pdfViewUrl = `https://drive.google.com/file/d/${pdfFile.getId()}/view?usp=sharing`;
  // 如果需要尝试直接下载,可以使用:
  // var downloadUrl = pdfFile.getDownloadUrl();

5. 通过客户端脚本打开链接,触发下载或预览

由于Apps Script的服务器端脚本不能直接控制用户的浏览器行为(如打开新标签页),我们需要借助HtmlService来注入一段客户端JavaScript代码以实现此目的。

// 承接 downloadGeneratedDocAsPdf 函数内部

  // 5. 通过客户端脚本打开链接,触发下载或预览
  openUrlInNewTab(pdfViewUrl); // 调用辅助函数打开URL

  // 6. (可选)清理临时文件
  // 如果不需要保留原始Google Doc和生成的PDF,可以将其移动到回收站
  // docFile.setTrashed(true); // 将原始Google Doc移至回收站
  // pdfFile.setTrashed(true); // 将生成的PDF移至回收站
}

/**
 * 辅助函数:通过在模态对话框中嵌入JavaScript来在浏览器新标签页中打开URL。
 * 适用于从Google Sheets按钮或自定义菜单触发的Apps Script。
 * @param {string} url 要打开的URL。
 */
function openUrlInNewTab(url) {
  var htmlOutput = HtmlService.createHtmlOutput('')
      .setWidth(100).setHeight(1); // 创建一个几乎不可见的微小对话框
  SpreadsheetApp.getUi().showModalDialog(htmlOutput, '正在打开PDF...'); // 显示对话框
}

完整代码示例

将上述所有片段整合,得到一个完整的Apps Script函数:

/**
 * 根据用户输入创建Google文档,并将其导出为PDF。
 * 该函数可绑定到Google Sheets中的按钮或自定义菜单。
 */
function downloadGeneratedDocAsPdf() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var data = sheet.getDataRange().getValues();

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

  // 假设 genData 函数已在其他地方实现,用于根据参数生成内容
  var problems = genData(
    userParams[0], userParams[1], userParams[2],
    userParams[3], userParams[4], userParams[5]
  );

  // 1. 创建Google文档并获取其ID
  var documentTitle = `Problems: ${userParams.toString().replace(/,/g, ", ")}`;
  var doc = DocumentApp.create(documentTitle);
  var docId = doc.getId(); // 获取新创建文档的ID
  var body = doc.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");
  }

  // 必须保存并关闭文档,确保所有更改已写入文件系统,以便DriveApp可以访问最新内容
  doc.saveAndClose();

  // 2. 将Google文档转换为PDF Blob
  var docFile = DriveApp.getFileById(docId); // 根据文档ID获取文件对象
  var pdfBlob = docFile.getAs('application/pdf'); // 将文件内容转换为PDF格式的Blob

  // 3. (可选)在Google Drive中创建PDF文件并命名
  // 这一步是可选的,如果只是想直接下载而不保留在Drive中,可以跳过。
  // 但为了获取一个稳定的下载链接,通常会先创建。
  var pdfFileName = `${documentTitle.replace(/[: ]/g, "_")}.pdf`; // 清理标题作为文件名
  var pdfFile = DriveApp.createFile(pdfBlob).setName(pdfFileName); // 在Drive中创建新文件

  // 4. 获取PDF的查看/下载链接
  // getDownloadUrl() 可以直接获取下载链接,但Apps Script中直接触发下载可能受权限限制。
  // 对于Apps Script,更推荐的方式是打开PDF的预览链接,用户可以在预览界面选择下载。
  var pdfViewUrl = `https://drive.google.com/file/d/${pdfFile.getId()}/view?usp=sharing`;

  // 5. 通过客户端脚本打开链接,触发下载或预览
  openUrlInNewTab(pdfViewUrl);

  // 6. (可选)清理临时文件
  // 如果不需要保留原始Google Doc和生成的PDF,可以将其移动到回收站
  // docFile.setTrashed(true); // 将原始Google Doc移至回收站
  // pdfFile.setTrashed(true); // 将生成的PDF移至回收站
}

/**
 * 辅助函数:通过在模态对话框中嵌入JavaScript来在浏览器新标签页中打开URL。
 * 适用于从Google Sheets按钮或自定义菜单触发的Apps Script。
 * @param {string} url 要打开的URL。
 */
function openUrlInNewTab(url) {
  var htmlOutput = HtmlService.createHtmlOutput('')
      .setWidth(100).setHeight(1); // 创建一个几乎不可见的微小对话框
  SpreadsheetApp.getUi().showModalDialog(htmlOutput, '正在打开PDF...'); // 显示对话框
}

// genData 函数的占位符,实际应根据您的业务逻辑

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

557

2023.06.20

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

395

2023.07.04

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

756

2023.07.04

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

478

2023.09.01

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

474

2023.09.04

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

1051

2023.09.04

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

659

2023.09.12

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

554

2023.09.20

菜鸟裹裹入口以及教程汇总
菜鸟裹裹入口以及教程汇总

本专题整合了菜鸟裹裹入口地址及教程分享,阅读专题下面的文章了解更多详细内容。

0

2026.01.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 4万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 2.4万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

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