google-sheet-s3

Google Apps Script that publishes a Google Sheet to Amazon S3 as a JSON file. Auto-updates on edit & maintains data types. Creates an array of objects keyed by column header.

Turn a spreadsheet like this:

Into an auto-updating JSON file like this:

Get the add-on here on the Chrome Web Store.

Why?

Use case

"I want to display simple, structured, spreadsheet-like, publicly accessible data on a website (possibly with thousands of simultaneous visitors) that is easily updatable (possibly by multiple people at once) without the overhead and time of coding, deploying, and maintaining a full-blown web application."

Examples

Staff directory list, restaurant menu items listing, sports team standings page, live blog.

Why not [alternative]?

Doesn't require OAuth like the official Google Sheets API (no good for anonymous data viewing).
Not using deprecated APIs like Tabletop.js that could suffer an untimely disappearance at the whims of Google.
Doesn't require an intermediary web application like WSJ uses/used.
Not an alternative service like Airtable or Fieldbook that is powerful but costs 💰💰💰.
Not slow at returning data like Google Apps Script Web Apps seem to be. (If you're okay with 2000ms response times, this solution is easier because it doesn't involve S3. S3 response times tend to be 10-20x faster.)

Setup

Prerequisites

An Amazon S3 bucket for which you have:
- Created security credentials that have write permissions to the bucket.
- Added a CORS policy that allows GET requests from whatever origin (domain name) you want to access the data from. The default policy allows access from any origin. To enable, go to your S3 Management Console, right-click your bucket name, click Properties > Permissions > Add CORS Configuration > Save (modal dialog) > Save (again) (blue button in sidebar)
- Added a bucket policy that enables public viewing of the published JSON. To enable, go to your S3 Management Console, right-click your bucket name, click Properties > Permissions > Add bucket policy > [Paste the text below to allow everyone public view access] > Save (modal dialog) > Save (again) (blue button in sidebar)

Bucket policy for public read-only access

{
	"Version": "2012-10-17",
	"Statement": [
		{
			"Sid": "AddPerm",
			"Effect": "Allow",
			"Principal": "*",
			"Action": "s3:GetObject",
			"Resource": "arn:aws:s3:::PUT-YOUR-BUCKET-NAME-HERE/*"
		}
	]
}

Instructions

Create or open an existing Google Sheet.
Format the sheet so that the first row contains the column headers you want your JSON objects to have as properties. Example:
Install and enable the add-on.
In the spreadsheet's menu, go to Add-ons > Publish to S3 > Configure...
Fill in the S3 bucket name, path within the bucket (leave blank if none), and AWS credentials that allow write access to the bucket.
Click "Save". The S3 URL of your JSON-ified spreadsheet will be shown.

Did I miss something in these instructions? Not working as expected? Feel free to file an issue.

That's it! Any time you make a change to the spreadsheet, the changes will be re-published to the JSON file. The JSON file's filename is taken from the spreadsheet ID, so the spreadsheet can be renamed without breaking the URL.

Usage notes

The add-on only looks at the sequentially first sheet tab (called "Sheet1" by default). It won't publish or respond to changes on other tabs.
The add-on will ignore columns that don't have a value in the header (row 1) of the spreadsheet.
The add-on will ignore empty rows, skipping over them to the next row with values.
A blank cell in a row is represented in the JSON as null. So if you have a column that could have missing or optional values, be sure to handle the null value in your consuming code.

Development setup instructions

Create a new Google Apps Script with files whose names and content matches the ones in this repo (minus this readme).
Add the Amazon S3 API Binding.
In the menu bar, click Publish > Test as add-on...
Select a version, for "Installation Config", choose "Installed and enabled", and select a document (must be a spreadsheet). Save.

Developement links for version published to Chrome Web Store

These links are not publicly accessible – please do not request access. They're only for my personal reference to develop the script. If you'd like to develop on this script yourself, follow the instructions above to set up a development environment.

samuellawerentz / google-sheet-s3