Migration guide or changelog

Hi there! I noticed you just published a version of this library compatible with Google Sheets V4.

At a first glance, what do existing codebases using this library need to do to migrate from the old version? It looks like a number of functions no longer take callbacks (and return Promises instead), but is there anything else that is materially different?

If there’s a changelog, that’d be awesome.

Thanks!

[theoephraim]

I had considered it, but figured the effort would be better spent on making sure the general docs were really solid. I’ll see if I can make some time to get something together. In general quite a lot has changed, but I’ve tried to make sure it still is very simple to use. Google’s v4 api is very different so some things really had to change and I had no choice.

Off the top of my head:

• everything is promise based so no more callbacks (promises are now much better with async/await)
• when fetching rows, you can no longer use queries or ordering (google no longer supports the row-based calls, so I had to recreate them as much as possible)
  • also the issue with an empty row breaking things is now gone, but empty rows will be fetched
• use doc.loadInfo() which loads props that live on the doc, rather than returning the info with doc.getInfo()
• Column header values used to be normalized by google, but are now used as is. For example, if you had a column header of “Phone Number”, to access a row value in the old version would be row.phonenumber and now it’s row['Phone Number']
• cell interaction is very different, but should be even easier to use
  • load cells with sheet.loadCells() (can use a filter like sheet.loadCells('A1:F10'))
  • access specific cells with sheet.getCell(row, col) or sheet.getCellByA1('D5')
  • make changes cell.value = "newValue" or cell.formula = "=SUM(A1:D1)"
  • save all unsaved changes using sheet.saveUpdatedCells()

[theoephraim]

going to close as it’s now been quite a while. I’ve also added a changelog file and will keep it up to date as we move forward!

Thanks 😄