The Google Sheets component is a data component that allows users to connect to and interact with Google Sheets spreadsheets to read and write data.
It can carry out the following tasks:
Alpha
The component definition and tasks are defined in the definition.yaml and tasks.yaml files respectively.
In order to communicate with Google, the following connection details need to be
provided. You may specify them directly in a pipeline recipe as key-value pairs
within the component's setup block, or you can create a Connection from
the Integration Settings
page and reference the whole setup as setup: ${connection.<my-connection-id>}.
Create a new Google Sheets spreadsheet with multiple sheets.
Input Field ID Type Description Task ID (required) taskstring TASK_CREATE_SPREADSHEETTitle titlestring Title of the new spreadsheet. Sheets (required)sheetsarray[object] Configuration for sheets to create.
Input Objects in Create Spreadsheet Sheets Configuration for sheets to create.
Field Field ID Type Note Headers headersarray Column headers for the sheet. Sheet Name namestring Name of the sheet.
Output Field ID Type Description Spreadsheet ID shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'.
Delete a Google Sheets spreadsheet.
Input Field ID Type Description Task ID (required) taskstring TASK_DELETE_SPREADSHEETSpreadsheet ID (required) shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'.
Output Field ID Type Description Success successboolean Result of the operation.
Add a new sheet to an existing Google Sheets spreadsheet.
Input Field ID Type Description Task ID (required) taskstring TASK_ADD_SHEETSpreadsheet ID (required) shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'. Headers headersarray[string] Column headers for the sheet. Sheet Name (required) sheet-namestring Name of the sheet.
Output Field ID Type Description Success successboolean Result of the operation.
Remove a sheet from a Google Sheets spreadsheet.
Input Field ID Type Description Task ID (required) taskstring TASK_DELETE_SHEETSpreadsheet ID (required) shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'. Sheet Name (required) sheet-namestring Name of the sheet.
Output Field ID Type Description Success successboolean Result of the operation.
Add a new column to a Google Sheets spreadsheet.
Input Field ID Type Description Task ID (required) taskstring TASK_CREATE_SPREADSHEET_COLUMNSpreadsheet ID (required) shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'. Sheet Name (required) sheet-namestring Name of the sheet. Column Name (required) column-namestring Name of the column.
Output Field ID Type Description Success successboolean Result of the operation.
Delete a column from a Google Sheets spreadsheet.
Input Field ID Type Description Task ID (required) taskstring TASK_DELETE_SPREADSHEET_COLUMNSpreadsheet ID (required) shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'. Sheet Name (required) sheet-namestring Name of the sheet. Column Name (required) column-namestring Name of the column.
Output Field ID Type Description Success successboolean Result of the operation.
List all rows in a Google Sheets spreadsheet.
Input Field ID Type Description Task ID (required) taskstring TASK_LIST_ROWSSpreadsheet ID (required) shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'. Start Row start-rownumber The starting row number to retrieve (1-based index). End Row end-rownumber The ending row number to retrieve (1-based index). Sheet Name (required) sheet-namestring Name of the sheet.
Output Field ID Type Description Rows Data rowsarray[object] Multiple rows data with row numbers and data.
Output Objects in List Rows Rows Data Field Field ID Type Note Row Number row-numbernumber Row number to update (1-based index) Row Data row-valuejson Row data in JSON format where keys are column names and values are the corresponding cell values
Find multiple rows based on column value in a Google Sheets spreadsheet.
Input Field ID Type Description Task ID (required) taskstring TASK_LOOKUP_ROWSSpreadsheet ID (required) shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'. Sheet Name (required) sheet-namestring Name of the sheet. Column Name (required) column-namestring Name of the column. Search Value (required) valuestring Value to search for in the specified column.
Output Field ID Type Description Rows Data rowsarray[object] Multiple rows data with row numbers and data.
Output Objects in Lookup Rows Rows Data Field Field ID Type Note Row Number row-numbernumber Row number to update (1-based index) Row Data row-valuejson Row data in JSON format where keys are column names and values are the corresponding cell values
Get a single row from a Google Sheets spreadsheet.
Input Field ID Type Description Task ID (required) taskstring TASK_GET_ROWRow Number (required) row-numbernumber The row number to retrieve (1-based index). Spreadsheet ID (required) shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'. Sheet Name (required) sheet-namestring Name of the sheet.
Output Field ID Type Description Row Data rowobject Row data with row number and data.
Output Objects in Get Row Row Data Field Field ID Type Note Row Number row-numbernumber Row number to update (1-based index) Row Data row-valuejson Row data in JSON format where keys are column names and values are the corresponding cell values
Get multiple rows from a Google Sheets spreadsheet.
Input Field ID Type Description Task ID (required) taskstring TASK_GET_MULTIPLE_ROWSRow Numbers (required) row-numbersarray[integer] The row numbers to retrieve (1-based indices). Spreadsheet ID (required) shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'. Sheet Name (required) sheet-namestring Name of the sheet.
Output Field ID Type Description Rows Data rowsarray[object] Multiple rows data with row numbers and data.
Output Objects in Get Multiple Rows Rows Data Field Field ID Type Note Row Number row-numbernumber Row number to update (1-based index) Row Data row-valuejson Row data in JSON format where keys are column names and values are the corresponding cell values
Insert a single row into a Google Sheets spreadsheet.
Input Field ID Type Description Task ID (required) taskstring TASK_INSERT_ROWSpreadsheet ID (required) shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'. Sheet Name (required) sheet-namestring Name of the sheet. Row Data row-valuejson Row data in JSON format where keys are column names and values are the corresponding cell values
Output Field ID Type Description Row Data rowobject Row data with row number and data.
Output Objects in Insert Row Row Data Field Field ID Type Note Row Number row-numbernumber Row number to update (1-based index) Row Data row-valuejson Row data in JSON format where keys are column names and values are the corresponding cell values
Insert multiple rows into a Google Sheets spreadsheet.
Input Field ID Type Description Task ID (required) taskstring TASK_INSERT_MULTIPLE_ROWSSpreadsheet ID (required) shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'. Row Values row-valuesarray[json] Array of row data in JSON format where keys are column names and values are the corresponding cell values Sheet Name (required) sheet-namestring Name of the sheet.
Output Field ID Type Description Rows Data rowsarray[object] Multiple rows data with row numbers and data.
Output Objects in Insert Multiple Rows Rows Data Field Field ID Type Note Row Number row-numbernumber Row number to update (1-based index) Row Data row-valuejson Row data in JSON format where keys are column names and values are the corresponding cell values
Update a row in a Google Sheets spreadsheet.
Input Field ID Type Description Task ID (required) taskstring TASK_UPDATE_ROWSpreadsheet ID (required) shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'. Sheet Name (required) sheet-namestring Name of the sheet. Row Data (required)rowobject Row data with row number and data.
Input Objects in Update Row Row Data Row data with row number and data.
Field Field ID Type Note Row Number row-numbernumber Row number to update (1-based index) Row Data row-valuejson Row data in JSON format where keys are column names and values are the corresponding cell values
Output Field ID Type Description Row Data rowobject Row data with row number and data.
Output Objects in Update Row Row Data Field Field ID Type Note Row Number row-numbernumber Row number to update (1-based index) Row Data row-valuejson Row data in JSON format where keys are column names and values are the corresponding cell values
Update multiple rows in a Google Sheets spreadsheet.
Input Field ID Type Description Task ID (required) taskstring TASK_UPDATE_MULTIPLE_ROWSSpreadsheet ID (required) shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'. Sheet Name (required) sheet-namestring Name of the sheet. Rows Data (required)rowsarray[object] Multiple rows data with row numbers and data.
Input Objects in Update Multiple Rows Rows Data Multiple rows data with row numbers and data.
Field Field ID Type Note Row Number row-numbernumber Row number to update (1-based index) Row Data row-valuejson Row data in JSON format where keys are column names and values are the corresponding cell values
Output Field ID Type Description Rows Data rowsarray[object] Multiple rows data with row numbers and data.
Output Objects in Update Multiple Rows Rows Data Field Field ID Type Note Row Number row-numbernumber Row number to update (1-based index) Row Data row-valuejson Row data in JSON format where keys are column names and values are the corresponding cell values
Delete a row from a Google Sheets spreadsheet.
Input Field ID Type Description Task ID (required) taskstring TASK_DELETE_ROWSpreadsheet ID (required) shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'. Sheet Name (required) sheet-namestring Name of the sheet. Row Number (required) row-numbernumber Row number to update (1-based index).
Output Field ID Type Description Success successboolean Result of the operation.
Delete multiple rows from a Google Sheets spreadsheet.
Input Field ID Type Description Task ID (required) taskstring TASK_DELETE_MULTIPLE_ROWSSpreadsheet ID (required) shared-linkstring Shared link of the spreadsheet. You can get the shared link by clicking 'Share' button and selecting 'Copy link'. Sheet Name (required) sheet-namestring Name of the sheet. Row Numbers (required) row-numbersarray[integer] Row numbers to update (1-based indices).
Output Field ID Type Description Success successboolean Result of the operation.