{{ transformations:ExportGoogleSheetsAction.png}}
====== EXPORT GOOGLE SHEETS ======
Category: Export / App & Cloud\\

\\ 
=====Description=====
This action exports data from EasyMorph to Google Sheets.

It can work in three modes:
  * Create a new spreadsheet
  * Create a new sheet in an existing spreadsheet
  * Replace data in an existing sheet within an existing spreadsheet

\\ 
=====Action settings=====
^ Setting  ^ Description  ^
|Connector<sup>*</sup>|Select the pre-configured connector, or create a new connector, to the Google Drive.  See [[connectors:googledrive|Google Drive connector]] for details.|
|Batch size | Select the number of rows exported at once. A higher number works faster but can exceed web request limits. For extra wide tables use a lower batch size.  Options:  //100//, //1000//, or //10000//.  |
|Spreadsheet|Select whether to export to an existing sheet or to create a new sheet.  Options: //Select existing// or //Create new//.  See the tables below for details.|
<sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\

\\ 
====Export to an existing spreadsheet options====
^Setting ^Description ^
|File path<sup>*</sup>|Browse to the folder and select the file to be exported to.|
|Spreadsheet doesn't exist|Select what EasyMorph will do if the selected spreadsheet does not exist.  Options:  //Fail// (stop and return a\\ warning) or //Create// (create a new spreadsheet).|
|Sheet|Select whether to export to an existing sheet, or create a new one.|
|Sheet name<sup>*</sup>|Select the existing sheet export to, or, if creating a new sheet, enter the sheet name.|
|Sheet doesn't exist|Select what EasyMorph will do if the selected sheet does not exist.  Options:  //Fail// (stop and return a warning)\\ or //Create sheet// (create a new sheet).|
<sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\

\\ 
====Create a new spreadsheet options====
^Setting ^Description ^
|Folder<sup>*</sup>|Select the existing folder in the Google Drive to create the new folder in.|
|File name<sup>*</sup>|Enter the file name of the new spreadsheet.|
|Spreadsheet already exists|Select what EasyMorph will do if a spreadsheet with the entered file name already exists.  Options:  //Fail// (stop\\ and return a warning) or //Replace contents// (overwrite sheet).|
|Sheet<sup>*</sup>|Enter the name of the sheet to be created.|
<sup>*</sup> Setting can be specified using a [[:parameters|parameter]].\\


\\ 
=====Remarks=====
When exporting to either an existing spreadsheet or a new one, the //File path// setting will populate once the //Connector// has been selected or created.

When working with an existing spreadsheet, the //Sheet name// setting will populate once the //File name// has been selected.  If sheet names are not appearing in the list, click the "Refresh" button to the right.\\

\\ 
=====See also=====

  * [[transformations:importgooglesheets|Import Google Sheets]]
  * [[connectors:googledrive|Google Drive connector]]
