本文详细介绍了如何利用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 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表格触发下载，您可以在表格中插入一个绘图或按钮，并为其分配一个客户端脚本函数。
-
在Google表格中创建按钮：
- 插入 > 绘图。
- 绘制一个形状，添加文本如“下载PDF”。
- 保存并关闭。
- 右键点击绘图，选择“分配脚本”。
- 输入您希望执行的客户端函数名，例如 handleDownloadClick。
-
在您的Apps Script项目（Code.gs文件）中添加以下HTML文件：
- 文件 > 新建 > Html文件，命名为 Dialog.html。
- 将以下内容粘贴到 Dialog.html 中：
-
在Code.gs中添加一个函数来打开这个对话框：
/** * 在Google表格中显示一个包含下载按钮的自定义对话框。 */ function showDownloadDialog() { var html = HtmlService.createHtmlOutputFromFile
