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

2024-08-26 12:07:38作者：宣聪麟

项目介绍

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：用于处理表单数据。

form-to-google-sheets

Store HTML form submissions in Google Sheets.

项目地址：https://gitcode.com/gh_mirrors/fo/form-to-google-sheets

登录后查看全文