能否用Google Apps Script实现Sheets内嵌图片转Docs？求可靠方案

问题描述 #

我正在使用Google Apps Script开发函数，尝试将来自服务器的Google Sheets数据及内嵌图片转移至Google Docs。目前数据格式化已正常实现，但不确定内嵌图片的转移是否可行。
注：我曾查阅2020年一篇使用OverGridImage实现类似功能的帖子，想了解如今是否有更完善的解决方案。
我尝试了以下代码，但未达到预期效果，请问通过Apps Script是否可实现该需求？

原测试代码 #

function sendToCell() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const images = sheet.getImages(); 
  const doc = DocumentApp.create("Cell Images");
  const body = doc.getBody();
  
  if (images.length === 0) {
    SpreadsheetApp.getUi().alert("cell images not found");
    return;
  }

  images.forEach(image => {
    const blob = image.getBlob();
    const position = image.getAnchorCell().getA1Notation(); 
    
    body.appendParagraph(`Image from cell: ${position}`);
    body.appendImage(blob);
  });
}

问题分析与解决方案 #

你的代码仅处理了覆盖在单元格上方的浮动图片，但Google Sheets中的内嵌图片分为两类：

1. 浮动在单元格上方的图片（通过sheet.getImages()获取）
2. 直接嵌入单元格内部的图片（需通过单元格的getImages()方法获取）

原代码未处理第二种场景，这是未达预期的核心原因。以下是兼容两种图片类型的完善方案：

改进后的代码 #

function transferSheetImagesToDoc() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const doc = DocumentApp.create("Sheet Images to Doc");
  const body = doc.getBody();
  let totalImages = 0;

  // 处理覆盖在单元格上的浮动图片
  const floatingImages = sheet.getImages();
  if (floatingImages.length > 0) {
    body.appendHeading("浮动图片（覆盖单元格）", DocumentApp.ParagraphHeading.HEADING2);
    floatingImages.forEach(img => {
      const blob = img.getBlob();
      const anchorCell = img.getAnchorCell();
      const cellPos = anchorCell ? anchorCell.getA1Notation() : "无锚定单元格";
      
      body.appendParagraph(`来自位置：${cellPos}`);
      const insertedImg = body.appendImage(blob);
      // 可选：调整图片适配文档宽度
      insertedImg.setWidth(300);
      totalImages++;
    });
  }

  // 处理单元格内部的内嵌图片
  const dataRange = sheet.getDataRange();
  const numRows = dataRange.getNumRows();
  const numCols = dataRange.getNumColumns();

  if (numRows > 0 && numCols > 0) {
    body.appendHeading("单元格内嵌图片", DocumentApp.ParagraphHeading.HEADING2);
    for (let row = 1; row <= numRows; row++) {
      for (let col = 1; col <= numCols; col++) {
        const cell = sheet.getRange(row, col);
        const cellImages = cell.getImages();
        if (cellImages.length > 0) {
          const cellPos = cell.getA1Notation();
          body.appendParagraph(`来自单元格：${cellPos}`);
          cellImages.forEach(img => {
            const blob = img.getBlob();
            const insertedImg = body.appendImage(blob);
            insertedImg.setWidth(300);
            totalImages++;
          });
        }
      }
    }
  }

  if (totalImages === 0) {
    SpreadsheetApp.getUi().alert("未找到任何图片");
    doc.setName("无图片的文档");
  } else {
    SpreadsheetApp.getUi().alert(`成功转移${totalImages}张图片`);
  }
}

关键优化点 #

• 同时兼容浮动图片与单元格内嵌图片两种类型
• 增加图片尺寸调整逻辑，避免图片过大破坏文档布局
• 按图片类型分类展示，提升文档可读性
• 优化图片计数与用户提示信息

补充说明 #

目前Apps Script API已完善支持两种图片类型的读取与导出，无需依赖旧的OverGridImage专属逻辑，上述代码可直接覆盖所有常见的Sheets内嵌图片场景。

内容的提问来源于stack exchange，提问作者SG0d11