关于Google Forms关联Google Sheets的GAS脚本HTTP POST功能咨询

嘿，我看你正在用Google Forms做活动注册，还关联了Google Sheet，想用GAS脚本在表格有变更的时候发HTTP POST请求对吧？先帮你理理现有代码的逻辑，再把没写完的部分补全，顺便给你一些关键的注意事项～

现有代码逻辑梳理 #

首先看你提供的两个函数：

• uuid_v2：这个函数用于给指定单元格范围生成UUID，支持单个单元格或多行多列的批量处理，空单元格会保持为空，非空单元格会生成唯一标识，很适合给每条注册记录加唯一ID。
• sentinelAgent：这是一个表格变更事件触发器函数，会在Google Sheet发生变更时自动触发，你已经写了日志打印和变更类型判断的逻辑，只需要补全后续的HTTP POST部分。

补全后的完整脚本 #

function uuid_v2(range) {
  return Array.isArray(range) ? range.map(row => row.map(cell => cell === '' ? '' : Utilities.getUuid())) : (range === '' ? '' : Utilities.getUuid());
}

function sentinelAgent(e){
  Logger.log("Invoking sentinelAgent...");
  FormApp.getActiveForm();
  Logger.log("Event Type: " + e.changeType);
  Logger.log("Event details: " + JSON.stringify(e));

  if(e.changeType=="EDIT" || e.changeType=="INSERT_ROW"){ 
    // 只处理编辑行或插入新行的情况，对应注册数据更新或新增
    var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
    // 替换成你的表单响应工作表名称，比如默认的"表单响应 1"
    var sheet = spreadsheet.getSheetByName("表单响应 1"); 
    if (!sheet) {
      Logger.log("未找到指定的工作表！");
      return;
    }

    // 获取触发变更的行号和该行的所有数据
    var rowIndex = e.range.getRow();
    var rowData = sheet.getRange(rowIndex, 1, 1, sheet.getLastColumn()).getValues()[0];
    
    // 准备要发送的POST数据，根据你的表格列结构调整字段
    var payload = {
      timestamp: rowData[0], // 假设第一列是表单提交时间戳
      fullName: rowData[1],  // 第二列是姓名
      email: rowData[2],     // 第三列是邮箱
      registrationId: rowData[3] // 第四列是uuid_v2生成的唯一ID（如果有的话）
      // 其他字段根据你的表单字段对应添加
    };
    
    // 配置HTTP POST请求参数
    var options = {
      method: "post",
      contentType: "application/json",
      payload: JSON.stringify(payload),
      muteHttpExceptions: true // 开启后请求失败不会直接中断脚本，方便调试
    };
    
    try {
      // 替换成你的目标API接口地址
      var response = UrlFetchApp.fetch("https://your-api-endpoint.com/submit", options);
      Logger.log("POST请求成功，响应内容: " + response.getContentText());
    } catch (error) {
      Logger.log("POST请求失败，错误信息: " + error.toString());
    }
  }
}

关键注意事项 #

• 配置触发器：必须给sentinelAgent函数添加onChange触发器才能自动触发：
  1. 打开脚本编辑器，点击左侧的触发器图标（时钟样式）
  2. 点击“添加触发器”，选择sentinelAgent函数，事件源选“从电子表格”，事件类型选“当更改时”
• 替换关键参数：记得把代码里的工作表名称和API地址替换成你自己的实际信息
• 字段映射调整：payload里的字段要和你的Google Sheet列顺序对应，比如如果你的邮箱在第五列，就改成rowData[4]（因为数组索引从0开始）
• 授权问题：第一次运行脚本或配置触发器时，会提示授权，按照步骤完成即可，需要允许脚本访问你的电子表格和发送HTTP请求
• 调试日志：可以通过脚本编辑器的“查看”->“日志”查看请求的触发情况和响应结果，方便排查问题

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