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 }


People also enjoyed…

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 existen

Create a dividend income tracker with Google Sheets by simply using pivot tables

As my investment strategy is to buy stocks that pay regular and stable dividends during a long-term period, I need to monitor my dividends income by stocks, by months, and by years, so that I can answer quickly and exactly the following questions: How much dividend did I receive on a given month and a given year? How much dividend did I receive for a given stock in a given year? Have a given stock's annual dividend per share kept increasing gradually over years? Have a given stock's annual dividend yield been stable over years? In this post, I explain how to create a dividend tracker with Google Sheets. Manage stock transactions with Google Sheets Create dividend tracker with Google Sheets Track annual dividend amount of stocks Track dividend amount by month and by year Track annual dividend per share of stocks Track annual dividend yield of stocks Demo Conclusion References Manage stock transactions with Google Sheets I use a spreadsheet on Goo

How to convert column index into letters with Google Apps Script

Although Google Sheets does not provide a ready-to-use function that takes a column index as an input and returns corresponding letters as output, we can still do the task by leveraging other built-in functions ADDRESS , REGEXEXTRACT , INDEX , SPLIT as shown in the post . However, in form of a formula, that solution is not applicable for scripting with Google Apps Script. In this post, we look at how to write a utility function with Google Apps Script that converts column index into corresponding letters. With the solution in the form of a formula , we don't even need to understand how column index and letters map each other. With apps script, we need to understand the mapping to come up with an algorithm. In a spreadsheet, columns are indexed alphabetically, starting from A. Obviously, the first 26 columns correspond to 26 alphabet characters, A to Z. The next 676 columns ( 26*26 ), from 27th to 702nd, are indexed with 2 letters. [AA, AB, ... AY, AZ], [BA, BB, ... BY, BZ],