Skip to main content

Google Apps Script tips and tricks

When working with Google Apps Script, there are some tasks that I need to perform quite often. For that, I create a list of snippets that I can easily copy whenever needed. In this post, I share my useful snippets and my tips and tricks when working with apps script. If you have any snippet/tip/trick, you can share in the comment section.

Effective use of the GOOGLEFINANCE function to get historical prices of stocks in a spreadsheet (Sheets, Apps Script)

As I manage my stock portfolio with Google Sheets, I have used the GOOGLEFINANCE function to get the historical prices of a stock. However, I experienced that the repetitive use of the GOOGLEFINANCE function cause performance issues for my spreadsheet. To avoid that problem, I create for each stock a dedicated tab to store its historical prices during a period that I'm interested in.

For example, if I need to get prices of GOOGL stock during the last 10 years

  • I create a new tab and name it GOOGL (the ticker symbol itself).
  • I put in the A1 cell this formula =GOOGLEFINANCE("GOOGL","price",TODAY()-10*365,TODAY()).
  • As the result, the column A and B contain respectively Date and Close prices of GOOGL during the last 10 years.
  • And then:
    • If I need to query the prices directly in the spreadsheet, I will use the VLOOKUP function on the above sheet instead of repetitive use of the GOOGLEFINANCE function.
    • If I need to query the prices in an Apps Script program, I will read the content of the above sheet in an object whose key is Date and whose value is Close price.

/** * Each symbol has its own sheet for its historical prices. * * Return a map from date to close price on that date. * { * '2020-01-31': 22.30, * '2020-02-01': 21.54 * } * @param {String} symbol */ function getHistoricalPricesBySymbol(symbol) { var spreadsheet = SpreadsheetApp.getActive() var historySheet = spreadsheet.getSheetByName(symbol) var rows = historySheet.getRange('A:B').getValues() var priceByDate = {} for (var i = 1; i < rows.length; i++) { // Start from 1 to ignore headers var tDate = rows[i][0] if (tDate) { tDate = getDateString(rows[i][0]) var close = rows[i][1] priceByDate[tDate] = close } else { break // it means empty row. } } return priceByDate } /** * Convert date to a string YYYY-MM-DD * @param {Date} aDate * @returns String */ function getDateString(aDate) { return aDate.getFullYear() + '-' + (aDate.getMonth() + 1) + '-' + aDate.getDate() }

Clean empty cells for a sheet (Sheets, Apps Script)

When working on a spreadsheet, I often use Apps Script for automating some workflows, such as, create a new sheet and populate some data into that. Most of the time, I know in advance how many cells I need to store the data but apps script tends to create more cells than needed. For instance, each new sheet is created by default with 26 columns and 1000 rows. So it is quite wasted and not optimal for reading the sheet later on. Moreover, if we have too many sheets, we need to be aware of a spreadsheet's limitation in terms of size. In my opinion, it is better to not have empty cells and I always clean empty cells of the sheet after populating data into it. Here is the snippet with Google Apps Script.

function cleanEmptyCells(sheet) { var lastColumn = sheet.getLastColumn() var totalNumberOfColumns = sheet.getMaxColumns() if (totalNumberOfColumns > lastColumn) { sheet.deleteColumns(lastColumn + 1, totalNumberOfColumns - lastColumn) } var lastRow = sheet.getLastRow() var totalNumberOfRows = sheet.getMaxRows() if (totalNumberOfRows > lastRow) { sheet.deleteRows(lastRow + 1, totalNumberOfRows - lastRow) } }

Get letter for a column index (Sheets, Apps Script)

Array in Javascript is indexed numerically, starting from 0, whereas, columns in a sheet are indexed alphabetically. If I iterate an array to populate data in columns, I need to convert a numerical index to a column letter. For example, an index 53 corresponds to the column BA in a sheet. Below is the utility function that I wrote to do the conversion. You can find a demo in this post or you can convert column index to column letter directly with formulas in a spreadsheet.

function getColumnLetters(columnIndexStartFromOne) { const ALPHABETS = ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'] if (columnIndexStartFromOne < 27) { return ALPHABETS[columnIndexStartFromOne - 1] } else { var res = columnIndexStartFromOne % 26 var div = Math.floor(columnIndexStartFromOne / 26) if (res === 0) { div = div - 1 res = 26 } return getColumnLetters(div) + ALPHABETS[res - 1] } }

Copy a sheet as HTML table (Sheets, Apps Script)

I often need to extract some sample data in Google Sheets and present it in my blog as an HTML table. However, when copying a selected range in Google Sheets and paste it outside the Google Sheets, I only get plain text. That's why I wrote the function below to help me copying a selected range in Google Sheets as an HTML table. You can find a demo in this post.

function copyAsHTMLTable() { var spreadsheet = SpreadsheetApp.getActive(); var values = spreadsheet.getActiveRange().getDisplayValues() var text = '<table>' for (var row = 0; row < values.length; row++) { text += '<tr>' for (var col = 0; col < values[0].length; col++) { text += '<td>' text += values[row][col] text += '</td>' } text += '</tr>' } text += '</table>' var ui = SpreadsheetApp.getUi() ui.alert('Please manually select and copy the text below', text, ui.ButtonSet.OK) }

Add a menu on opening a spreadsheet (Sheets, Apps Script)

function onOpen() { var spreadsheet = SpreadsheetApp.getActive() var menuItems = [ { name: 'Generate Historical Prices Sheets', functionName: 'generateHistoricalPricesSheets' }, { name: 'Delete Historical Prices Sheets', functionName: 'deleteHistoricalPricesSheets' }, { name: 'Show Historical Prices Sheets', functionName: 'showHistoricalPricesSheets' }, { name: 'Hide Historical Prices Sheets', functionName: 'hideHistoricalPricesSheets' }, { name: 'Update Values Sheet', functionName: 'updateValuesSheet' }, { name: 'Generate Evolutions Sheet', functionName: 'generateEvolutionsSheet' }, { name: 'Generate Buy-Sell Evaluation Sheet', functionName: 'generateBuySellEvaluationSheet' }, { name: 'Generate Benchmarks Sheet', functionName: 'generateBenchmarksSheet' }, { name: 'Clear All Caches', functionName: 'clearAllCaches' } ] spreadsheet.addMenu('Lion Stock Portfolio Tracker', menuItems) }

Hide a sheet by name (Sheets, Apps Script)

function hideSheet(sheetName) { var spreadsheet = SpreadsheetApp.getActive() var sheet = spreadsheet.getSheetByName(sheetName) if (sheet) { sheet.hideSheet() } }

Show a sheet by name (Sheets, Apps Script)

function showSheet(sheetName) { var spreadsheet = SpreadsheetApp.getActive() var sheet = spreadsheet.getSheetByName(sheetName) if (sheet) { sheet.showSheet() } }

Create a new sheet or clear content of an old sheet if exists (Sheets, Apps Script)

function createNewOrClearOldSheet(sheetName) { var spreadsheet = SpreadsheetApp.getActive() var sheet = spreadsheet.getSheetByName(sheetName) if (sheet) { sheet.clear() } else { sheet = spreadsheet.insertSheet(sheetName, spreadsheet.getNumSheets()) } return sheet }


Popular posts from this blog

Create personal stock portfolio tracker with Google Sheets and Google Data Studio

I have been investing in the stock market for a while. I was looking for a software tool that could help me better manage my portfolio, but, could not find one that satisfied my needs. One day, I discovered that the Google Sheets application has a built-in function called GOOGLEFINANCE which fetches current or historical prices of stocks into spreadsheets. So I thought it is totally possible to build my own personal portfolio tracker with Google Sheets. I can register my transactions in a sheet and use the pivot table, built-in functions such as GOOGLEFINANCE, and Apps Script to automate the computation for daily evolutions of my portfolio as well as the current position for each stock in my portfolio. I then drew some sort of charts within the spreadsheet to have some visual ideas of my portfolio. However, I quickly found it inconvenient to have the charts overlapped the table and to switch back and forth among sheets in the spreadsheet. That's when I came to know the existenc

Stock Portfolio Tracker Dashboard With Google Data Studio

In the series of building personal stock portfolio tracker, we have learned how to use Google Sheets to register transactions . We have then used the pivot table and GOOGLEFINANCE function to compute the latest position of the stock portfolio . We have made a step further to use Apps Scripts to compute automatically and daily the stock portfolio's evolution . However, after all, we have several tables of data as the result which do not tell any story yet. We need to present those data in graphs to understand the portfolio's performance and make improvements accordingly. We can effectively plot graphs in different aspects directly in Google Sheets as it provides many charting tools. However, in my experience, having charts and data in the same spreadsheet is not very convenient because charts and tables tend to overlap each other and of lack of interactivity. We should have a dedicated dashboard to have an overview of the stock portfolio and we can do it greatly with Google Data

Demo stock portfolio tracker with Google Sheets

As explained in the post Create personal stock portfolio tracker with Google Sheets and Google Data Studio , a personal stock portfolio tracker consists of 2 main elements: a spreadsheet in Google Sheets and an interactive dashboard in Google Data Studio. You can take a look at the sample spreadsheet below to have an idea of how the data is organized and related. It is possible to make a copy of the spreadsheet to study it thoroughly. Make a copy Note Disclaimer Make a copy Click here to make a copy Note To better understand the overall concept, please check out this post Create personal stock portfolio tracker with Google Sheets and Google Data Studio . Disclaimer The post is only for informational purposes and not for trading purposes or financial advice.

Monitor stock portfolio with Google Sheets (Pivot table and GOOGLEFINANCE function)

As an investor, it is important to know the latest state of the stock portfolio. We need to know what stocks currently owned in the portfolio, how many shares for each one, how much dividend or gain contributed so far by each stock, etc. As we have registered stock transactions in a spreadsheet with Google Sheets, we can easily have the latest update from the stock portfolio by using pivot tables and GOOGLEFINANCE function. Use a pivot table to group transactions by symbols Configure the pivot table Positions Use GOOGLEFINANCE function to get real-time information for stocks Conditional formatting columns Demo Note References Disclaimer Use a pivot table to group transactions by symbols The pivot table helps to see relationships between data points. To see how each stock contributes to the portfolio, we will create a pivot table that originated from the Transactions sheet. Select the Transactions sheet. Select the 5 columns A:E . In the menu at the top, click Dat