The Google Sheets API is a RESTful interface that lets you read and modify a spreadsheet's data. The most common uses of this API include the following tasks:
- Create spreadsheets
- Read and write spreadsheet cell values
- Update spreadsheet formatting
- Manage Connected Sheets
Below is a list of common terms used in the Sheets API:
The primary object in Google Sheets that can contain multiple sheets, each with structured information contained in cells. Every spreadsheet is represented by a Spreadsheet resource and has a unique
spreadsheetIdvalue, containing letters, numbers, hyphens, or underscores. You can find the spreadsheet ID in a Google Sheets URL:
An individual field of text or data within a sheet. Cells are arranged in rows and columns, and can be grouped together as a range of cells. Each cell is represented by a CellData resource, but doesn't have a unique ID value. Instead, cells are identified by their row and column coordinates.
- A1 notation
A syntax used to define a cell or range of cells with a string that contains the sheet name and starting and ending cell coordinates using column letters and row numbers. This method is most common and useful when referencing an absolute range of cells.
Sheet1!A1:B2refers to the first two cells in the top two rows of Sheet1.
Sheet1!A:Arefers to all the cells in the first column of Sheet1.
Sheet1!1:2refers to all the cells in the first two rows of Sheet1.
Sheet1!A5:Arefers to all the cells of the first column of Sheet 1, from row 5 onward.
A1:B2refers to the first two cells in the top two rows of the first visible sheet.
Sheet1refers to all the cells in Sheet1.
'My Custom Sheet'!A:Arefers to all the cells in a sheet named "My Custom Sheet." Single quotes are required for sheet names with spaces, special characters, or an alphanumeric combination.
- R1C1 notation
A syntax used to define a cell or range of cells with a string that contains the sheet name and starting and ending cell coordinates using row numbers and column numbers. This method is less common, but can be useful when referencing a range of cells relative to a given cell's position.
Sheet1!R1C1:R2C2refers to the first two cells in the top two rows of Sheet1.
R1C1:R2C2refers to the first two cells in the top two rows of the first visible sheet.
Sheet1!RCrefers to the cell that is three rows below and one column to the right of the current cell.
- Named range
A defined cell or range of cells with a custom name to simplify references throughout an application. A named range is represented by a FilterView resource.
- Protected range
A defined cell or range of cells that cannot be modified. A protected range is represented by a ProtectedRange resource.
To get started with the Google Sheets API: