Google Sheets & Charts Service Plugin

☝
Hint: For the information on how to obtain Service Account Keys for this plugin, please read here: https://docs.zeroqode.com/other/obtaining-google-service-account-keys

Demo to preview the settings

Introduction

The API lets your apps:
  • Import, export and format Sheets data
  • Control conditional formatting
  • Build and edit charts embedded in a sheet
  • Configure data validation
  • Create and update named and protected ranges
  • Add and adjust filtered views
  • Create and manipulate pivot tables
... and even more!
Make use of over 35 actions and counting plus an easy to use data parser element to help get your rows & columns ready faster.
☝
Hint: How to obtain Google service account Keys please check here: https://docs.zeroqode.com/other/obtaining-google-service-account-keys

Google Sheets (Service Account)

Using a service account has many benefits including the ability to authenticate itself with the Sheets API and perform actions, modifications, read & write operations. It allows you to use Sheets as a database, A report / chart builder, perform collaboration tasks, calculate, formulate and communicate.
Something a bit different:
For the most part, the most used feature in a sheet is to write Columns or Rows. Most plugins and other secure integrations connect via the API Connector meaning that when it comes to adding a list of data or trying to format your values a certain way things quickly turn into long complex workflows or roadblocks. We go about this a little differently,
Firstly notice there are two Action's at the bottom of the list below that end with either (ROW TOOL) or (COLUMN TOOL), These have all the safety of the API Connector, all the benefit's of being a core feature to your app but also allow the use of the 'Sheet's Data Maker' element.
Here is how:
1. Drop the element on your page.
2. Setup an event for Column's & an Event for Row's
Image without caption
☝
Hint: * Remember when adding a run of actions that include the data making element, to provide some delays.
Handy to know:
  • Its worth noting that Spreadsheet ID's, Sheet ID's **& _Sheet Names _are referenced throughout this plugin and they stand for different things. Eg. A spreadsheet has an ID like so,_ 1PciD2dkT3IJTuIJ0484XjdoalxBfSXStkL3sFpIYj4QT, each sheet inside the spreadsheet also has an id. This ID ranges in its value but usually the default first page in the spreadsheet will have the number 0 as its ID. Common ID's after the initial sheet will often look like this, 241376695. The other identifiable property is a sheets name, this can be the title you assigned it or something like this, Sheet0. Another quick note on ID's, you will also come across the chart ID**_. Keep in mind that some action's require one of these or a mix of these & sometimes even the same ID in to places
Image without caption
  • There are a number of calls that have (custom) added to the end of their names, These are for your own creative use cases and the way they work is simple - I have forced the returning data to only contain the one thing that always carries on, the spreadsheet ID. So you will see an action such as this one below and you will know that the ability is in this case to update a spreadsheet. Because it will only return the spreadsheets is your able to follow the doc links in the plugin to Google Sheets Reference Doc's and build your own functional extra's/styles/formats/abilities using the JSON body.
Image without caption
βœ…
Example 'Create Sheet' JSON body.
javascript
{ "properties": { "title": "myCustomSheet", "defaultFormat": { "backgroundColor": { "alpha": 1, "blue": 12, "green": 22, "red": 30 }, "horizontalAlignment": "CENTER", "borders": { "bottom": { "color": { "alpha": 12, "blue": 45, "green": 121, "red": 41 }, "style": "DASHED", "width": 122 }, "left": { "color": { "alpha": 1.0, "blue": 121, "green": 200, "red": 50 }, "style": "DASHED", "width": 100 }, "right": { "color": { "alpha": 2, "blue": 121, "green": 121, "red": 0 }, "style": "DASHED", "width": 140 }, "top": { "color": { "blue": 0, "alpha": 0, "green": 0, "red": 0 }, "style": "DASHED", "width": 0 } }, "hyperlinkDisplayType": "PLAIN_TEXT", "textFormat": { "bold": false, "fontSize": 0, "foregroundColor": { "alpha": 0, "blue": 0, "green": 0 } } } }}
  • Its a good idea to setup a 'Do when unhandled error occurs' event as it can be very easy to input values or ranges that can cause an error to return.
  • REMEMBER - Your service account is the owner of a sheet to begin with. if you provide the link to the sheet to a user you must **first use either the 'Allow spreadsheet access' or 'Transfer Ownership' actions to avoid permission issues.

Available Actions

  • Get Spreadsheet
  • Get Spreadsheet (Data)
  • Get Spreadsheet Properties (Data)
  • Get Spreadsheet Properties
  • Get Sheet Values (Range)
  • Get Sheet Values (Column)
  • Get Sheet Values (Row)
  • Add Sheet to Spreadsheet
  • Remove Sheet from Spreadsheet
  • Clear Ranges
  • Create Spreadsheet (Custom)
  • Update a Spreadsheet (Custom)
  • Add Charts to Spreadsheet (Custom)
  • Delete Chart From Spreadsheet (Custom)
  • Add Protected Range
  • Conditional Formatting Spreadsheet (Custom)
  • Data Validation Spreadsheet
  • Move/Resize Chart From Spreadsheet (Custom)
  • Read Charts on Spreadsheet (Custom)
  • Copy Sheet to Another
  • Add Empty Rows to Sheet
  • Add Empty Columns to Sheet
  • Write to a Cell
  • Write a Column Sheet
  • Write a Row to Sheet
  • Find & Replace
  • Move a Column
  • Move a Row
  • Auto Resize a Row
  • Auto Resize a Column
  • Allow Spreadsheet Access
  • Restrict Spreadsheet Access
  • Send Writer rights
  • Allow Spreadsheet Access to the User
  • Write a Row (ROW TOOL)
  • Write a Column (COLUMN TOOL)

Changelogs

Update 29.07.2022 - Version: 1.15.0

  • Fixed data call to read chart data from the sheet

Update 01.12.2022 - Version: 1.16.0

  • Changed API Call "Transfer Ownership" to "Send Writer rights".

Update 07.12.2022 - Version: 1.17.0

  • Added show docs for a "Send Writer rights" action.

Update 28.03.2023 - Version: 1.20.0

  • Updated documentation for actions.