JSPM

form-google-sheets

0.1.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 1
  • Score
    100M100P100Q12883F
  • License MIT

Uses Google Apps Scripts with Google Sheets to provide a POST endpoint for form data that is parsed into sheet fields.

Package Exports

  • form-google-sheets

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (form-google-sheets) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

form-google-sheets

Maintenance Status NPM version Travis build

Uses Google Apps Scripts with Google Sheets to provide a POST endpoint for form data that is parsed into sheet fields.

https://techcoop.github.io/form-google-sheets/

Requirements

  1. Google Account
  2. Google Sheet with column headers
  3. node > 6.0.0 (Optional)
  4. yarn (or npm latest) > 0.10.0 (Optional)

Installation

Google Scripts

  1. Change the values below as needed
  2. Make sure SHEET_NAME matches your spreadsheet exactly
  3. Click on Publish and select "Deploy as web app"
  4. Select new (or save over existing version)
  5. In "Execute the app as" select yourself
  6. In "Who has access to the app" Select "Anyone, even anonymous"
  7. Click Update
  8. Copy and paste the URL and use this to post information to
  9. Make sure form data fields match the header fields exactly

NPM package

yarn add form-google-sheets

Usage

ES6

import { Form } from 'form-google-sheets'

const endpoint = 'https://script.google.com/macros/s/AKfycbyEBGqfIUmxrLKMp_LlAlH8C_VO9vfRvtvwgjAS9lEi8Vu8xho/exec'
const form = new Form(endpoint).then((event) => {
  console.log('SUCCESS')
  console.log(event)
}).catch((event) => {
  console.log('ERROR')
  console.log(event)
})

Node

var Form = require('form-google-sheets').Form

var endpoint = 'https://script.google.com/macros/s/AKfycbyEBGqfIUmxrLKMp_LlAlH8C_VO9vfRvtvwgjAS9lEi8Vu8xho/exec'
var form = new Form(endpoint).then((event) => {
  console.log('SUCCESS')
  console.log(event)
}).catch((event) => {
  console.log('ERROR')
  console.log(event)
})

Javascript

<script src="form-google-sheets.js"></script>
var endpoint = 'https://script.google.com/macros/s/AKfycbyEBGqfIUmxrLKMp_LlAlH8C_VO9vfRvtvwgjAS9lEi8Vu8xho/exec'
var form = new FormGoogleSheets.Form(endpoint).then(function(event) {
  console.log('SUCCESS')
  console.log(event)
}).catch(function(event) {
  console.log('ERROR')
  console.log(event)
})

Testing

Google Scripts

There is a test function setup that you can change to include your own fields and make sure your form is setup correctly.

  1. Change the testData in test_post()
  2. Move to Run in the top menu
  3. Click function test_post()

Client library

# Run unit test
yarn test

Releasing

# Create new versioned release
yarn run release

Examples

You can see examples of use in javascript under /docs.

You can see the (view only) sheet that this posts to here: https://docs.google.com/spreadsheets/d/1SRRfFOpIJyW6tZB1TP3wJf01CFISviIMFEJDgwoqq5w/edit?usp=sharing

Original Source

https://github.com/dwyl/html-form-send-email-via-google-script-without-server

Contributing

All contributors are welcome, please follow CONTRIBUTING.md

Contributors

colin@techcoop.group