Node.js操作Google Sheets基于模板新建工作表并复制样式的问题

问题根因 #

你当前使用的spreadsheets.values.get和spreadsheets.values.update接口仅负责读写单元格的纯内容数据，不会读取、传输背景色、字体、格式规则、数据验证等样式元信息，因此只能得到无格式的内容副本。

解决方法 #

直接使用Google Sheets API提供的spreadsheets.sheets.copyTo接口即可完整复制整个模板工作表，自动保留所有内容、样式、格式配置，无需手动逐区域同步数据和样式，实现逻辑如下：

1. 先获取template模板工作表的数字ID（复制接口需要源工作表ID，不能仅用名称匹配）
2. 调用复制接口将模板工作表复制到当前表格，自动生成带完整样式的副本
3. 将新生成的副本重命名为你需要的工作表名称即可

修改后的参考代码 #

const createNewSheet = async (req, res) => {
    const spreadsheetId = '1';
    const newSheetName = 'test';

    // 1. 获取所有工作表元数据，找到template对应的sheetId
    const sheetList = await g.sheets.spreadsheets.get({
        spreadsheetId,
        fields: 'sheets.properties'
    });
    const templateSheet = sheetList.data.sheets.find(sheet => sheet.properties.title === 'template');
    if (!templateSheet) {
        return res.status(400).send({error: "模板工作表不存在"});
    }
    const templateSheetId = templateSheet.properties.sheetId;

    // 2. 复制模板工作表到当前表格，自动保留所有样式和内容
    const copiedSheet = await g.sheets.spreadsheets.sheets.copyTo({
        spreadsheetId,
        sheetId: templateSheetId,
        requestBody: {
            destinationSpreadsheetId: spreadsheetId // 复制到当前同一份表格
        }
    });

    // 3. 将新复制的工作表重命名为目标名称
    await g.sheets.spreadsheets.batchUpdate({
        spreadsheetId,
        requestBody: {
            requests: [
                {
                    updateSheetProperties: {
                        properties: {
                            sheetId: copiedSheet.data.sheetId,
                            title: newSheetName
                        },
                        fields: 'title'
                    }
                }
            ]
        }
    });

    res.send({success: "success"});
}

补充说明 #

该方法会完整保留模板的所有配置，包括单元格样式、条件格式、数据验证、冻结行列、公式等，无需额外处理。如果需要修改新工作表的部分内容，后续再调用values.update接口修改对应单元格即可，不会影响其他已有的样式配置。

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