Skip to main content

Google Activities

Use the Google group to read and write Google Sheets spreadsheets from a workflow, and to hold the OAuth credentials that Google API calls authenticate with.

The fifteen Sheets activities are built on the REST Client and call https://sheets.googleapis.com. The endpoint, method and query parameters are prefilled; you supply the spreadsheet, the range, and the payload.

Available activities

Read values

ActivityPurpose
GetValuesReads one range of values
BatchGetValuesReads several ranges in one call
BatchGetValuesByDataFilterReads ranges selected by data filter

Write values

ActivityPurpose
UpdateValuesWrites values to a range
AppendValuesAppends values after the last row of a range
BatchUpdateValuesWrites several ranges in one call
BatchUpdateValuesByDataFilterWrites ranges selected by data filter

Clear values

ActivityPurpose
ClearValuesClears one range
BatchClearValuesClears several ranges in one call
BatchClearValuesByDataFilterClears ranges selected by data filter

Spreadsheets and sheets

ActivityPurpose
CreateSpreadsheetCreates a spreadsheet
GetSpreadsheetRetrieves a spreadsheet and its metadata
GetSpreadsheetByDataFilterRetrieves a spreadsheet selected by data filter
BatchUpdateSpreadsheetApplies a batch of structural updates
CopySheetToSpreadsheetCopies a sheet into another spreadsheet

Connection resources

These are resources rather than workflow steps. They hold OAuth credentials and scopes that the activities above authenticate with.

ResourcePurpose
GmailOAuth connection for Gmail
GoogleDriveOAuth connection for Google Drive
GoogleSheetConnection for Google Sheets
GoogleSheetProviderOAuth connection provider for Google Sheets
GoogleSheetsOauthOAuth connection for Google Sheets

Authentication

Every Sheets activity authenticates with OAuth 2. Auth Type offers a single option, OAuth 2, and it is the default. Auth Resource takes the OAuth resource holding the credentials.

note

The Auth Type help text on these activities reads "Options: No Auth, Basic, API Key, OAuth 2", but the field itself offers only OAuth 2. The help text is inherited from the REST Client the activities are built on.

The data filter variants

Five activities come in a plain form and a ByDataFilter form. The plain form takes the range from the Range or Ranges field; the ByDataFilter form takes no range field at all, because the filter that selects the cells travels in the request body instead.