如何通过Sheets API使用CellImageBuilder更新单元格图片？

嗨，我来帮你解决这个问题！你遇到的情况其实是因为Sheets API和SpreadsheetApp的CellImage对象不兼容导致的——前者不认后者封装的专属对象，直接用Values.update传的话，就会被当成字符串处理，所以单元格里显示的是"CellImage"而不是图片。

要实现用Sheets API插入单元格图片，得换用batchUpdate方法，因为这个接口支持更复杂的单元格操作，正好符合你要批量处理的需求。下面给你两种可行的方案：

方案1：插入内嵌式单元格图片（和SpreadsheetApp效果一致） #

这种方式会把图片直接嵌入单元格内，和你用setValue(cellImage)的效果完全相同，代码示例如下：

const sheetId = '0000000000000';
const photoId = '0000000000000';

// 先获取图片的base64数据（这部分和你原来的代码一样）
const image = DriveApp.getFileById(photoId);
const mimeType = image.getMimeType();
const base64 = Utilities.base64Encode(image.getBlob().getBytes());
const imageData = `data:${mimeType};base64,${base64}`;

// 使用Sheets API的batchUpdate设置单元格的richValue
Sheets.Spreadsheets.batchUpdate({
  requests: [
    {
      updateCells: {
        range: {
          sheetId: sheetId,
          startRowIndex: 0, // A1对应的行索引是0（从0开始计数）
          endRowIndex: 1,
          startColumnIndex: 0, // A列对应的列索引是0
          endColumnIndex: 1
        },
        rows: [
          {
            values: [
              {
                richValue: {
                  runs: [
                    {
                      inlineImage: {
                        sourceUrl: imageData
                      }
                    }
                  ]
                }
              }
            ]
          }
        ],
        fields: 'richValue' // 指定要更新的字段为richValue
      }
    }
  ]
}, sheetId);

方案2：插入浮动图片（可自由调整大小位置） #

如果你需要图片可以拖动调整，或者覆盖多个单元格，用这种插入浮动图片的方式更合适：

// 前面的图片数据获取部分和方案1一致
const sheetId = '0000000000000';
const photoId = '0000000000000';
const image = DriveApp.getFileById(photoId);
const mimeType = image.getMimeType();
const base64 = Utilities.base64Encode(image.getBlob().getBytes());
const imageData = `data:${mimeType};base64,${base64}`;

// 使用batchUpdate插入浮动图片
Sheets.Spreadsheets.batchUpdate({
  requests: [
    {
      insertImage: {
        imageUrl: imageData,
        sheetId: sheetId,
        // 定位图片到A1单元格的位置（左上角对齐）
        startRowIndex: 0,
        startColumnIndex: 0,
        endRowIndex: 1,
        endColumnIndex: 1
      }
    }
  ]
}, sheetId);

额外提示 #

如果要批量执行多个操作（比如同时更新多个单元格的图片、修改文本等），只需要把多个请求对象放到requests数组里就可以了，一次batchUpdate就能完成所有操作，完美符合你的需求。

备注：内容来源于stack exchange，提问作者user22309393