首页
/ 开源项目 `form-to-google-sheets` 使用教程

开源项目 `form-to-google-sheets` 使用教程

2024-08-26 07:15:59作者:宣聪麟

项目介绍

form-to-google-sheets 是一个开源项目,旨在帮助开发者将HTML表单的提交数据直接存储到Google Sheets中。该项目利用Google Apps Script和Fetch API,通过JavaScript处理表单数据并将其发送到Google Sheets。

项目快速启动

1. 创建一个新的Google Sheet

首先,访问Google Sheets并创建一个新的空白模板表格。将其重命名为“Email Subscribers”或其他你喜欢的名称。在第一行输入以下标题:

A B C
1 Email Timestamp

2. 创建Google Apps Script

在Google Sheets中,依次点击 扩展程序 -> Apps Script,然后粘贴以下代码:

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

function initialSetup() {
  const activeSheet = SpreadsheetApp.getActiveSpreadsheet()
  scriptProp.setProperty('key', activeSheet.getId())
}

function doPost(e) {
  const lock = LockService.getScriptLock()
  lock.tryLock(10000)

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

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

    const 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)
  }

  finally {
    lock.releaseLock()
  }
}

3. 部署为Web应用

在Apps Script编辑器中,依次点击 部署 -> 新建部署,选择 Web应用,设置为 任何人,然后点击 部署。记下生成的URL。

4. 创建HTML表单

创建一个HTML文件,包含以下内容:

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Form to Google Sheets</title>
</head>
<body>
  <form id="myForm">
    <input type="email" name="Email" required>
    <button type="submit">Submit</button>
  </form>

  <script>
    const form = document.getElementById('myForm')
    form.addEventListener('submit', e => {
      e.preventDefault()
      fetch('YOUR_GOOGLE_APPS_SCRIPT_URL', {
        method: 'POST',
        body: new FormData(form)
      }).then(response => response.json())
        .then(data => {
          if (data.result === 'success') {
            alert('Form submitted successfully!')
          }
        })
    })
  </script>
</body>
</html>

YOUR_GOOGLE_APPS_SCRIPT_URL 替换为你在步骤3中生成的URL。

应用案例和最佳实践

应用案例

  • 邮件订阅列表:收集网站访问者的电子邮件地址,并将其存储在Google Sheets中,以便后续的邮件营销活动。
  • 调查问卷:通过HTML表单收集用户反馈,并将数据存储在Google Sheets中进行分析。

最佳实践

  • 数据验证:在HTML表单中添加必要的输入验证,确保收集到的数据是有效的。
  • 安全性:确保Google Apps Script的URL保密,避免未授权访问。
  • 错误处理:在JavaScript代码中添加错误处理逻辑,以便在提交失败时提供用户反馈。

典型生态项目

  • Google Apps Script:用于处理表单数据并将其发送到Google Sheets。
  • Fetch API:用于在JavaScript中发送HTTP请求。
  • FormData:用于处理表单数据。
登录后查看全文
热门项目推荐
相关项目推荐