使用Google Apps Script（GAS）导出Google Sheet为PDF时是否存在设置边距的查询参数？

核心结论 #

GAS通过调用Google文档导出接口实现PDF导出时，完全支持对应GUI的边距设置能力，所有边距配置项都以查询参数的形式挂载在导出请求URL上，无需调用特殊SDK方法。
之前参考的同类导出教程未覆盖边距参数，是因为示例代码仅实现了最基础的导出逻辑，没有把接口支持的全部可配置项列全。

具体边距配置参数 #

预设边距档位 #

对应GUI内的三档预设边距选项，通过单一参数即可快速设置，无需单独传入四个方向的边距值：

• 参数名：pdmargins
• 支持的取值与GUI选项一一对应：
  • 0：默认边距
  • 1：窄边距
  • 2：宽边距

自定义边距 #

对应GUI内的自定义边距设置，可分别调整四个方向的边距数值，单位为英寸，取值范围为0-2的浮点数。传入自定义边距参数后，接口会自动忽略预设档位配置，完全匹配GUI的自定义设置逻辑：

• 上边距参数：top_margin
• 下边距参数：bottom_margin
• 左边距参数：left_margin
• 右边距参数：right_margin

代码示例 #

以下示例展示拼接带自定义边距的导出请求URL的逻辑：

// 替换为实际的表格ID
const targetSpreadsheetId = "xxxxxxx";
// 替换为需要导出的工作表gid
const targetSheetGid = "0";
// 拼接带0.5英寸自定义边距的导出URL
const exportPdfUrl = `https://docs.google.com/spreadsheets/d/${targetSpreadsheetId}/export?` +
  `format=pdf` +
  `&portrait=true` +
  `&size=A4` +
  `&top_margin=0.5` +
  `&bottom_margin=0.5` +
  `&left_margin=0.5` +
  `&right_margin=0.5` +
  `&gid=${targetSheetGid}`;

// 后续通过UrlFetchApp携带用户身份凭证请求该URL，即可拿到对应配置导出的PDF文件

注意事项 #

• 接口支持的边距可选范围与GUI完全一致，GUI内无法设置的边距数值，通过代码传入后也不会生效。
• 目前接口未开放自定义边距单位的配置，所有自定义边距的固定单位为英寸，可传入小数实现更精细的边距调整。

内容的提问来源于stack exchange，提问作者S.aad