无法向Google Sheets推送数组，寻求API调用解决方案

一、解决写入数据的API错误问题 #

你遇到的API错误核心原因是：Google Sheets的values.append接口要求values参数是二维数组（每行对应一个值数组），但你传入的是对象数组，API无法识别对象的键名，因此抛出"Unknown name"类错误。

修复步骤： #

1. 从transData的第一个对象中提取表头字段（确保后续数据顺序和表头对应）
2. 将每个对象转换为对应顺序的单元格值数组，组成二维数据数组
3. 合并表头与数据数组，调用接口完成写入

修改后的写入部分代码示例：

// 提取表头（从第一个对象的键获取）
const headers = Object.keys(transData[0]);
// 将对象数组转换为二维值数组
const valuesArray = [headers, ...transData.map(item => headers.map(key => item[key]))];

// 调用append接口写入数据
sheets.spreadsheets.values.append({
    auth: auth,
    spreadsheetId: sheetID,
    range: 'Sheet1!A:H',
    resource: {
        values: valuesArray
    },
    valueInputOption: 'USER_ENTERED',
}, (e, r) => {
    if (e) return console.log('The API returned an error: ' + e);
    console.log('数据写入成功:', r.data);
});

二、合并创建表格与写入数据的优化方案 #

你提到的合并创建与写入的需求完全可以实现——在调用spreadsheets.create接口时，直接在请求体中定义表格的结构和初始数据，无需先创建再更新，减少API调用次数，提升效率。

完整优化代码（使用async/await替代嵌套回调，更易维护）： #

const {google} = require('googleapis');
const auth = new google.auth.GoogleAuth({
    keyFile: './my-project.json',
    scopes: [
        'https://www.googleapis.com/auth/drive',
        'https://www.googleapis.com/auth/drive.file',
        'https://www.googleapis.com/auth/spreadsheets'
    ],
});

const createSpreadsheet = async (transData) => {
    try {
        const dateTime = new Date().toLocaleString();
        const label = `Placeholder - ${dateTime}`;
        const sheets = google.sheets('v4');
        const drive = google.drive({ version: "v3", auth });

        // 提取表头和转换数据格式
        const headers = Object.keys(transData[0]);
        // 构造行数据：表头行 + 数据行
        const rowData = [
            {
                values: headers.map(header => ({
                    userEnteredValue: { stringValue: header }
                }))
            },
            ...transData.map(item => ({
                values: headers.map(key => {
                    // 根据数据类型设置对应的值类型
                    const value = item[key];
                    if (typeof value === 'number') {
                        return { userEnteredValue: { numberValue: value } };
                    }
                    return { userEnteredValue: { stringValue: String(value) } };
                })
            }))
        ];

        // 一次性创建表格并写入数据
        const createResponse = await sheets.spreadsheets.create({
            resource: {
                properties: { title: label },
                sheets: [
                    {
                        properties: { title: 'Sheet1' },
                        data: [{ rowData }]
                    }
                ]
            }
        });

        const sheetID = createResponse.data.spreadsheetId;
        console.log('表格创建成功，ID:', sheetID);

        // 设置权限为任何人可查看
        await drive.permissions.create({
            fileId: sheetID,
            requestBody: {
                role: 'reader',
                type: 'anyone'
            }
        });
        console.log('权限设置完成');

        return sheetID;
    } catch (err) {
        console.error('操作失败:', err);
        throw err;
    }
};

// 调用示例
// const transData = [/* 你的数据数组 */];
// createSpreadsheet(transData);

代码说明： #

1. 用async/await替代嵌套回调，避免回调地狱，代码逻辑更清晰
2. 创建表格时直接写入表头和数据，减少一次API调用
3. 根据数据类型匹配userEnteredValue的类型（字符串/数字），确保数据格式正确
4. 统一错误捕获与处理，便于排查问题

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