如何避免重复向Google Sheet添加URL参数数据？

已实现页面加载时将URL参数（示例：https://example.com/page?Name=John&Email=john@gmail.com）同步至Google Sheet的功能，但存在重复添加问题：仅能阻止页面重载时的重复提交，用户在新标签页或其他设备打开同一URL时仍会生成重复记录。需要在添加数据前检查Google Sheet中是否已存在匹配参数，存在则终止添加操作。

核心逻辑是在Google Script的doPost接口中新增重复记录校验：通过关键参数（如Name和Email）查询表格已有数据，匹配到重复项则直接返回，不执行插入操作。

1. 修改Google Script代码 #

在插入新行前添加重复检查逻辑，完整代码如下：

var sheetName = 'Sheet1'
var scriptProp = PropertiesService.getScriptProperties()

function intialSetup () {
  var activeSpreadsheet = SpreadsheetApp.getActiveSpreadsheet()
  scriptProp.setProperty('key', activeSpreadsheet.getId())
}

function doPost (e) {
  const { Name, Email, sample } = e.parameter;
  if (sample == "delete") {
    var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName);
    var ranges = sheet.getDataRange();
    var values = ranges.getValues().filter(r => ![Name, Email].every(e => r.includes(e)));
    if (ranges.length == 0) {
      return ContentService.createTextOutput(`"${Email}" was not found.`);
    }
    ranges.clearContent().offset(0, 0, values.length, values[0].length).setValues(values);
    return ContentService.createTextOutput(`Rows including "${Email}" were deleted.`);
  }

  var lock = LockService.getScriptLock()
  lock.tryLock(10000)

  try {
    var doc = SpreadsheetApp.openById(scriptProp.getProperty('key'))
    var sheet = doc.getSheetByName(sheetName)

    // --- 新增重复检查逻辑 ---
    var dataRange = sheet.getDataRange().getValues();
    // 跳过表头，遍历所有行检查Name+Email是否重复
    const isDuplicate = dataRange.slice(1).some(row => {
      // 注意：索引需与你的表头列位置对应，这里假设Name在第1列、Email在第2列
      return row[0] === Name && row[1] === Email;
    });
    if (isDuplicate) {
      return ContentService
        .createTextOutput(JSON.stringify({ 'result': 'duplicate', 'message': '该记录已存在' }))
        .setMimeType(ContentService.MimeType.JSON);
    }
    // --- 重复检查逻辑结束 ---

    var headers = sheet.getRange(1, 1, 1, sheet.getLastColumn()).getValues()[0]
    var nextRow = sheet.getLastRow() + 1

    var newRow = headers.map(function(header) {
      return header === 'Timestamp' ? new Date() : e.parameter[header]
    })

    sheet.getRange(nextRow, 1, 1, newRow.length).setValues([newRow])

    return ContentService
      .createTextOutput(JSON.stringify({ 'result': 'success', 'row': nextRow }))
      .setMimeType(ContentService.MimeType.JSON)
  }

  catch (e) {
    return ContentService
      .createTextOutput(JSON.stringify({ 'result': 'error', 'error': e }))
      .setMimeType(ContentService.MimeType.JSON)
  }

  finally {
    lock.releaseLock()
  }
}

关键修改说明 #

• 新增重复校验：通过dataRange.slice(1).some()遍历表格数据（跳过表头），判断是否存在Name和Email完全匹配的记录。
• 重复拦截：检测到重复项时直接返回duplicate结果，终止后续插入流程。
• 修复原代码bug：删除逻辑中变量名错误（原代码用了未定义的email，改为Email）。

2. 前端JS优化（可选） #

如果需要在前端提示用户重复信息，可修改前端代码处理返回结果：

if (performance.navigation.type != performance.navigation.TYPE_RELOAD) {
  const queryParameters = Object.fromEntries(new URLSearchParams(window.location.search));

  const scriptURL = 'https://script.google.com/macros/s/script/exec';

  const data = new FormData();
  Object.entries(queryParameters).forEach(e => data.append(...e));
  fetch(scriptURL, { method: 'POST', body: data })
    .then(response => response.json())
    .then(result => {
      switch(result.result) {
        case 'success':
          console.log('数据添加成功！', result);
          break;
        case 'duplicate':
          console.log('记录已存在，无需重复添加', result);
          // 可添加前端提示，比如 alert(result.message)
          break;
        default:
          console.error('添加失败', result);
      }
    })
    .catch(error => console.error('请求出错！', error.message))
}

优化说明 #

• 将响应转为JSON格式，便于区分不同返回状态。
• 新增duplicate结果的处理分支，可根据需求添加用户提示。

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